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Preface 



This manual is a programming guide to DOS-Ill, a Hewlett-Packard Disc Operating System for 2000- 
series computer systems. Programmers using this manual should be familiar with the functions of 
batch-processing operating systems and one of the programming languages supported by the DOS-Ill 
Operating System. 

The Hewlett-Packard programming languages and program libraries that can operate under control 
of DOS-Ill are described in the following reference manuals: 

• HP ALGOL (02116-9072) 

• HP ASSEMBLER (24307-90014) 

• HP FORTRAN (021 1 6-9015) 

• HP FORTRAN IV (5951-1321) 

• RELOCA TABLE SUBR O UTINES (02116-91 780) 

Other information, which may be useful to the programmer, is included in the SMALL PROGRAMS 
MANUAL, the MANUAL OF DIAGNOSTICS and the SOFTWARE OPERATING PROCEDURES. 
These manuals contain custom-assembled modules pertaining to each customer's software and hard- 
ware configurations, and are supplied with each Hewlett-Packard computer system. 

This manual is divided into six functional parts: 

• Parti. DOS-HI OPERATING SYSTEM 

Part 1 defines the standard capabilities of DOS-Ill. It includes a summary of DOS-Ill organi- 
zation, hardware and software; definitions of DOS-Ill directives, EXEC calls and I/O routines; 
a description of the interaction of DOS-Ill and its subsystems; and a set of sample job decks. 

• Part 2. DOS-Ill EXTENDED FILE MANAGEMENT PACKAGE (EFMP) 

Part 2 describes the capabilities of the DOS-Ill Extended File Management Package (EFMP), 
which allows the programmer to extend the file-handling capabilities of the DOS-Ill Operating 
System. Part 2 contains sections on EFMP organization, EXEC calls and use of UTIL, the EFMP 
Utility Program. 
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Part 3. GENERATING AND LOADING DOS-Ill 

Part 3 gives complete instructions for generating and loading a DOS-Ill System. 

Part 4. DOS-Ill SYSTEMS PROGRAMMING 

Part 4 contains information which will help the advanced programmer to write his own EXEC 
modules, plan I/O drivers and use the DOS-Ill privileged mode capabilities. 

Part 5. ERROR CODES AND MESSAGES 

Part 5 is a complete set of all DOS-Ill Operating System error codes and messages. 

Part 6. APPENDIX AND INDEXES 

Part 6 contains an appendix of DOS-Ill system tables and three indexes: the first two are con- 
venient summaries of DOS-Ill directives and EXEC calls; the third refers to terms discussed in 
the manual. 
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PART 1 
DOS-Ill Operating System 



SECTION I 
DOS-HI Organization 



The DOS-Ill supervisory software consists of a Disc Monitor (DISCM) that resides in main memory ; 
EXEC modules which may reside either in main memory or on disc; and a Job Processor (JOBPR) 
that is disc-resident. Together these modules manage I/O processing, interrupt processing, executive 
processing, job processing, and file handling. 

Other DOS-Ill software consists of a series of relocatable binary software modules. Since each 
module is an independent, general-purpose program, the hardware and software configuration of 
the system is flexible. Modules can either reside in main memory or on the disc, at the user's option 
(specified during system generation). In a system with a small main memory, the modules can reside 
on the disc to save main memory space; in a large main memory system, modules can reside in main 
memory for greater efficiency. 



MAIN MEMORY LAYOUT 

When DOS-Ill is active, the main memory is divided into a User Area and a System Area (as shown 
in Figure 1-1). The Disc Monitor program handles all EXEC calls and, if they are legal, transfers 
them to the proper module for processing. The I/O drivers handle all actual I/O transfers of infor- 
mation. If some I/O drivers are disc-resident, they are read into main memory by the supervisor 
when needed. The User Area provides space for execution of user programs. 

In addition, large DOS-HI software modules, such as the FORTRAN Compilers, Assembler, Relocat- 
ing Loader, and Job Processor, reside on the disc and execute in the User Area. (See Appendix A 
for figures on disc and main memory layout.) 

If the memory protect option is present, a memory protect boundary is set between the System 
Area and the User Area. This boundary interrupts whenever a user program attempts to execute an 
I/O instruction (including a HALT) or to modify the System Area. (Instructions can reference the 
switch register and overflow register.) Programs to be run in the User Area must use EXEC calls for 
input/output, termination, suspension, and other external processes. 
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Figure 1-1. Functional Diagram of DOS-Ill 
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DOS-Ill OPERATION 

DOS-Ill operates in either keyboard or batch mode. In keyboard mode, the user enters statements 
and commands to the system (called directives) to control his programming job through a keyboard 
device (system console). Each line entered must terminate with a return and a linefeed. In batch 
mode, the user enters directives through a batch input device, sometimes integrated with a source 
program on punched cards, paper tape or magnetic tape, thus forming a job deck. Jobs can be 
stacked one upon another in a queue. 



Deleting Keyboard Errors 

To delete an entire line of input, strike rubout then linefeed. To delete the character just entered, 
strike Control-A (simultaneous "A" and control key striking). Each Control-A deletes one addi- 
tional preceding character. 



Batch Abort 

Some errors when encountered in batch mode cause a batch abort. When such an error occurs 
(mostly in response to a directive) DOS-Ill takes the following action: 

1. The offending directive and an error message is printed on the list device. 

2. JOB ABORTED is printed on both the system console and the list device. 

3. The offending statement and subsequent statements are ignored until a JOB, EJOB, or TYPE 
directive is encountered. The current operation is aborted and the next input is processed. 



DOS-Ill DIRECTIVES 

The DOS-Ill Supervisor operates in response to directives input by the programmer or operator. 
Directives are strings of up to 72 characters that specify tasks to DOS-Ill. They are entered in one 
of the two modes of DOS-Ill operation: keyboard or batch. 

The DOS-Ill directives are used for the following functions: 

Create, rename, edit, list, and dump user files (relocatable, absolute, loader-generated, 
source statements, and ASCII or binary data) 

Search the various disc subchannels for specified file names 

Check status of user disc tracks 

Turn on user programs or system programs such as FORTRAN and Assembler 

Examine and modify the logical organization of the I/O; rewind magnetic tapes and output 
end-of-file commands to magnetic tapes; output top-of-form commands to list devices 

Start and stop a job; type comments; suspend operations; resume execution of suspended 
programs 
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Assemble or compile, load and execute a user program 

Dump main or disc memory 

Set the date; abort programs; transfer to batch mode (from keyboard mode or batch mode); 
return to keyboard mode (from batch mode) 

Change the subchannel of the user disc 

Initialize (label) a disc subchannel 

Dump all (or part of) a disc to another disc 

Purge file name entries from the user file directory 

Repack discs to eliminate purged user files 

Reserve logical memory space for specific subsystems (Memory Management) 

DOS-Ill directives are described in Section II. 



DOS-Ill EXEC CALLS 

After being translated and loaded, an executing user program communicates with DOS-Ill by means 
of EXEC calls. An EXEC call is a JSB instruction which transfers control to the DOS-Ill Supervisor. 

The EXEC calls perform the following functions: 

• I/O read and write operations 

• User file and work area read and write operations 

• I/O control operations (backspace, EOF, etc.) 

• Request I/O status 

• Change the subchannel of the user disc 

• Request limits and status of WORK area (temporary disc storage) 

• Program completion 

• Program suspension 

• Loading of program segments or main programs 

• Request the time 

• Control of memory protect 

• Store values into base page memory locations 

• Memory Management 

• Programmatic file control 

DOS-Ill EXEC calls are described in Section III. 
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DOS-Ill INPUT/OUTPUT 

All I/O operations and interrupts are channeled through the DISCM section of the DOS-Ill Super- 
visor. DISCM is always main-memory resident and maintains ultimate control of the computer 
resources. 

I/O programming is device-independent. Programs written in FORTRAN, ALGOL, and Assembler 
specify a logical unit number (with a predefined function, such as data input) in I/O statements 
instead of a particular device. Logical unit numbers initially are assigned to appropriate devices by 
the operator during system generation, depending upon what is available and can be assigned during 
a job. Thus, the programmer need not worry about the type of input or output device performing 
the actual operation. 



PRIVILEGED INTERRUPT 

For DOS-Ill system interrupt processing, the I/O channel select codes are assigned decreasing priority. 
Channel 10 8 has the highest priority and channel 37 8 has the lowest. When an interrupt occurs on an 
I/O channel, system interrupt processing is disabled on all channels having a lower priority (higher 
number) until the higher priority interrupt processing is completed. 

DOS-Ill provides an optional capability which permits privileged interrupts on specific I/O devices 
(channels). These devices have their own user-supplied interrupt routines and have their interrupts 
processed without going through the system's central interrupt processor ($CIC). The system guaran- 
tees a response time of 100 microseconds for privileged device interrupts. (For a description of 
privileged interrupt driver routines, see Section 13.) 

The privileged interrupt capability is obtained by including a "fence" board in the system hardware 
configuration and notifying the system software of the existence of the fence during system gener- 
ation (see Section 10). The privileged interrupt fence physically separates privileged devices from 
system devices. Privileged devices are those with interface boards in I/O channels of a lower number 
(higher priority) than the fence. System devices are those with interface boards in I/O channels with 
a higher number than the fence. 

The DMA channels are always considered system devices although they reside on the privileged side 
of the fence. When the privileged interrupt option is included in the system, any DOS-Ill drivers 
which require DMA interrupts must explicitly inform the system of this fact. This is accomplished 
by issuing the following subroutine call from the driver before returning control to the system: 

EXT $SDMA 
JSB $SDMA 

When the last DMA interrupt has been received, the driver should inform the system that no further 
DMA interrupts are expected by issuing the following subroutine call: 

EXT $CDMA 
JSB $CDMA 

When the privileged interrupt fence is installed in the system and necessary privileged interrupt 
drivers are included, the user can access his privileged devices with standard I/O calls (JSB EXEC). 
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TIMING CAPABILITIES 

A library subroutine called $TIME is available to both system programs and user programs. The 
Time Base Generator is required to use this subroutine (see "Hardware Options"). $TIME provides 
the capability to set, reset, or release a timer (100 millisecond resolution). 



Note: Upon return from the $TIME subroutine, Memory Protect is 
disabled until a system request (JSB EXEC) is issued. 



When setting (activating) a timer, an initial time value is placed into a user-supplied buffer and this 
timer buffer is added to a linked list of currently active timers. When the timer expires, the sub- 
system, driver, or user receives temporary control from the system. A timer is reset by placing a 
new time value into an active timer buffer. A timer is released (deactivated) by removing the timer 
buffer from the linked list of active timers. It is possible to remove all timer buffers from the list 
with one calling sequence. 

To use $TIME, the program must include a timer buffer, a time-out processor routine, and a calling 
sequence. 



Timer Buffer 

A 4-word timer buffer must be available to $TIME. The address of this buffer is passed to $TIME 
to identify the desired timer. Timer buffer format is: 



Wordl 
Word 2 
Word 3 
Word 4 



16-bit buffer identifier 

Address of time-out processor routine 

Current time value 

System use only 
Address of next timer buffer in linked list 



Program must not modify word 3 or 4. 



Time-out Processor Routine 

Control is passed to the time-out processor routine when a specified timer expires. Unless the 
system was generated with the privileged interrupt option, the interrupt system will be OFF and 
should remain OFF during execution of the time-out processor routine. If the privileged interrupt 
option is included in the system, the interrupt system will be ON upon entry into the time-out 
processor. To prevent further privileged interrupts from occurring during execution of the time-out 
processor, the time-out processor must disable the interrupt system. 

Caution: Interrupts should not be disabled for more than 100 microseconds. 
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On entry into the time-out processor routine, the timer buffer is released from the timer list and 
the A- and B-registers set as follows: 

A = 16-bit identifier of the timer just expired (this allows one time-out 
processor to service many timers). 

B = 15-bit address of the timer buffer associated with the expired timer. 



Calling Sequence 

To set or reset a timer: 

EXT $TIME 



LDA VALUE 

LDB ATMBF 

JSB $TIME 

SZA 

JMP ERROR 



(Time specified in -100 milliseconds) 

(Address of timer buffer) 

(Set/reset timer) 

(If A = 0, no error; A = 1, illegal address) 



VALUE DEC -2 



(Set timer for 200 milliseconds) 



When this request is received, the list of timers is scanned for a matching timer buffer. If no match 
is found, a set request is assumed and the new entry is placed in the timer list. If a match is found, a 
reset request is assumed and the new value is stored into the existing timer buffer. 

On return from $TIME, the contents of the A-register indicate the termination condition: 

A = 0; normal termination 

A = 1 ; illegal timer buffer address 
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To release a timer: 





EXT $TIME 






CLA 


(Indicates release request) 




LDB ATMBF 


(Release a specific timer) 




or 


or 




CLB 


(Release all timers) 




JSB $TIME 


(Release timer) 




<return point> 




ATMBF 


DEF TMBUF[,I] 


(Address of timer buffer) 


TMBUF 


OCT n 


(16-bit identifier) 




DEF TOP[,I] 


(Address of time-out processor) 




BSS 2 


(Reserved for system) 



Choose one 



Time Buffer 



TOP 



NOP 



JMP TOPJ 



Time-out Processor 



Note: Routines using $TIME must remain main-memory resident during 
program execution because the system uses a linked list mechanism 
to keep track of the timers. 



DOS-Ill FILES 

Two types of files can be included in the DOS-Ill system: standard files (created by the STORE or 
EDIT directives) and files created under the Extended File Management Package (if EFMP is in- 
cluded in the system). 



Standard Files 

The disc provides quick access and mass storage for user files consisting of source statements, re- 
locatable, absolute and loader-generated object programs, or ASCII or binary data. Each file has 
a name that is used to reference it. 

Programs use the Work Area of the disc for temporary storage. The System Area contains files of 
systems programs, EXEC modules, a system directory, and system library subroutines. 
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DOS-Ill Extended File Management Package 

DOS-Ill installations can use the DOS-Ill Extended File Management Package (EFMP). This set of 
optional EXEC modules allows the user to exploit a more powerful file structure than that provided 
by DOS-Ill. EFMP files allow logical record sizes of varying lengths for different files, security codes, 
flexible buffering, sequential reads and writes with a pointer, and detailed status information. In 
addition, a utility program (UTIL) is available that operates in the User Area. UTIL makes those 
EFMP functions (except reads and writes), normally only usable through EXEC calls, usable from 
the keyboard. For more information on EFMP, see Part 2. 



DOS-Ill MEMORY MANAGEMENT 

A memory management EXEC module allows user and system programs to allocate and release 
buffer space within memory. The following memory management capabilities are provided: 

A directive (:MMGT) to specify and list subsystem names and block sizes. 

An initialization call (RCODE=35) to reserve a block of memory under a unique block name. 

A status call (RCODE=36) to interrogate the state of various blocks of memory. 

A buffer allocation call (RCODE=38) to subdivide blocks of memory into individual buffers. 
A unique buffer identification is assigned each buffer allocated. 

A buffer release call (RCODE=41) to release previously allocated buffer space. 



GENERATING A DOS-Ill SYSTEM 

DOS-IH is generated and loaded using two programs: 



• 



Configured DSGEN (the system generator) 



• BMDL (a bootstrap loader which loads the configured DOS-Ill from the disc into 
main memory); or an equivalent program contained on a ROM. 

First, DSGEN outputs instructions to the operator asking for information about the system. At the 
appropriate point in the dialogue, the operator loads in the relocatable binary modules which make 
up DOS-HI and specifies whether the modules are to be disc- or main-memory resident. Finally, 
DSGEN stores the configured DOS-Ill system on the disc in absolute form. (The disc is protected 
from alteration by a hardware override switch.) 

DOS-Ill then resides as a System Area and User Area on the disc. Each area is labeled and contains 
a directory of all the files contained within the area. The System Area contains system main-memory 
resident and disc-resident modules, while the User Area contains user files. 

To load DOS-Ill into main memory and begin system execution, the user executes a disc loader. 
The Loader loads all the modules designated main memory resident into main memory. (The disc- 
resident modules are brought into main memory when needed by the main-memory resident 
modules.) 
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DISC STORAGE 

Disc storage is divided into subchannels. Each subchannel is a logical disc, i.e., the dimensions do 
not necessarily correspond to the physical characteristics of the disc. Each subchannel contains 
203 tracks — typically three of which are reserved as spares. The smallest addressable unit on a 
disc is a sector. One sector contains 128 sixteen-bit words of storage. 

HP 2883/2884 

During system generation, the HP 2883 disc drives can be configured for one of two modes — four 
subchannels per drive or two subchannels per drive. In either case, the controller supports one or 
two drives (one drive is required). 

For the four subchannel per drive mode, each drive contains a removable pack of twenty disc sur- 
faces divided into four subchannels. Thus, the controller can support up to eight subchannels. 

For the two subchannel per drive mode, each drive contains a removable pack of twenty disc sur- 
faces divided into two subchannels. One controller supports up to four subchannels. A second 
controller (optional) can be added to provide support for up to eight subchannels. Subchannel 
assignments follow: 



2883/2884 
with four 
Subchannels 
per drive 



2883/2884 

with two 

Subchannels 

per drive 






1 


Disc Drive Numbers 





1 


2 


3 





4 







2 


4 


6 


1 

2 


b 
6 


Subchannel 
Assignments 










3 


7 




1 


3 


5 


7 



When two controllers are used (two subchannels per drive mode only) they must reside in contigu- 
ous I/O channel slots. In addition, the subchannels associated with the second controller (sub- 
channels 4 through 7) can contain only user discs — no generation or bootstrap operations are 
permitted on these subchannels. 

When an HP 2883/2884 is configured to the four-subchannel mode, each track contains 115 sectors. 
If it is configured to the two-subchannel mode, each track contains 230 sectors. Perhaps the con- 
cept of logical disc organization can be more clearly understood by studying the accompanying 
illustrations. 
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HP 2883/2884 

4 SUBCHANNEL MODE 

LOGICAL ORGANIZATION 



5 SURFACES = 
1 SUBCHANNEL 



SUBCHANNEL < 



SUBCHANNEL 1 ( 



SUBCHANNEL 2( 



SUBCHANNEL 3 ( 



IN 4-SUBCHANNEL MODE 
4 LOGICAL TRACKS = 
1 CYLINDER 




TOP SURFACE 
IS NOT USED 



5 PHYSICAL TRACKS = 
1 LOGICAL TRACK 



115 SECTORS PER LOGICAL 
TRACK (23 SECTORS PER 
SURFACE TIMES 5 PHYSICAL 
TRACKS) 



203 TRACKS 



BOTTOM SURFACE IS 
IS NOT USED 
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HP 2883/2884 

2SUBCHANNEL MODE 

LOGICAL ORGANIZATION 



10 SURFACES' 
1 SUBCHANNEL 



SUBCHANNELS / 



SUBCHANNEL 1 



IN 2-SUBCHANNEL 
MODE. 2 LOGICAL 
TRACKS-1CYLINDER 




TOP SURFACE 
IS NOT USED. 



10 PHYSICAL TRACKS' 
1 LOGICAL TRACK 



230 SECTORS PER TRACK 
(23 SECTORS PER SUR FACE 
TIMES 10 PHYSICAL TRACKS) 



203 TRACKS 



BOTTOM SURFACE 
IS NOT USED. 
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HP 7900/7901 

The controller for the moving-head disc supports up to four disc drives (one is required). Each 7900 
drive contains two discs: a fixed disc and a removable cartridge. Each 7901 drive contains one disc: 
a removable cartridge. Each disc is referenced through a subchannel of the controller. Therefore, 
the controller has a maximum of eight subchannels (numbered to 7). The subchannels are 
assigned as follows: 



7900 



7901 






1 


2 


3 


Disc Drive Numbers 





1 


2 


3 


1 


3 


5 


7 


Removable Subchannels 


1 


3 


5 


7 





2 


4 


6 


Permanent Subchannels 


None 



On the HP 7900/7901 disc drive^gaeh-track on the disc contains 48 sectors as shown in the 
following illustration. 



HP 7900/7901 
DISC ORGANIZATION 



2 SURFACES' 
1 SUBCHANNEL 



SUBCHANNEL 1 
(REMOVABLE! 



SUBCHANNEL (J 
{PERMANENTI 




203 TRACKS 



48 SECTORS PER TRACK 
(24 SECTORS PER SURFACE) 



THE HP 7901 HAS NO PERMANENT 
DISC; THUS NO CORRESPONDING 
SUBCHANNEL. 



DISC USAGE 

DOS-Ill normally allows two subchannels to be available to the user: one subchannel contains the 
system disc and the other contains the user disc (which may be the same subchannel as the system 
disc). The user subchannel assignment can be changed during job or program execution. In addi- 
tion, an optional system search mode is available to allow searching for user files on any specified 
subchannels. 
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The disc storage has four parts: 

1. The System Area 

Executable code created by the system generator and hardware protected ; includes 
DOS-Ill Supervisor and other system programs. 

2. The User Area (optional) 

User file directory and user files (data, object programs, source statements, etc.). 

3. The Work Area 

Temporary storage for the current job. 

4. Job Binary Area 

Temporary storage for relocatable object code generated by the Assembler and compilers; this 
is an area of variable size and starts from the end of the disc. 

All four of these areas can reside on the system subchannel, or the User Area can be on a separate 
subchannel. Only one User Area is available to the system at a time. The standard user subchannel 
is assigned at system generation time; this can be the system disc or another subchannel (removable 
or permanent disc). The UD directive and an analogous EXEC call allow the user to temporarily 
change the User Area to another subchannel. 

Automatic track switching is provided within each subchannel. 
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DOS-Ill HARDWARE REQUIREMENTS 

DOS-Ill controls the operation of HP 2100A and HP 2100S Computer systems, and HP 21MX Com- 
puter Series systems. Minimum hardware requirements depend on the type of computer system 
selected. 

The minimum hardware required for DOS-Ill operation is: 

1. a) An HP 2100A or HP 2100S Computer, with 16,384 words of main memory, and DMA; or, 

b) An HP 21MX-series Computer with 16,384 words of main memory, and a Dual-Channel 
Port Controller. 

2. Moving-head Disc device (HP 7900 Moving-head Disc Drive with fixed disc and removable 
cartridge; or HP 7901 Moving-head Disc Drive with removable cartridge; or HP 2883 Disc 
File with one removable pack). 

3. System Console device. 

4. Paper Tape Reader. 



Hardware Options 

The following hardware options are available: 

1. Time-base Generator (provides accounting times and time-of-day). 

2. Privileged Interrupt Fence. 

3. Floating-point hardware (standard for 21MX Computer Series). 

4. Additional main memory to a total of 24,576 or 32,768 words. 

5. Using extenders, additional I/O channels (up to channel 37 8 ). 

6. Memory Protect (not available for the HP 2105 Processor). 

7. Paper Tape Punch. 

8. Line Printer. 

9. Card Reader. 

10. Magnetic Tape Unit. 

11. Additional Disc Drives. (Maximum is four on HP 7900/7901; two on HP 2883 with four sub- 
channels per drive; and four on HP 2883 with two subchannels per drive.) 

12. CRT Display Console. 

13. Writable Control Store. 

14. Fast FORTRAN Processor. 
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DOS-Ill SOFTWARE 

Required Software 

The minimum software requirements for DOS-Ill are 

1. Absolute Programs 

a. DOS-Ill System Generator (DSGEN) 

b. DOS-Ill Bootstrap Loader 

c. SIO Drivers 

2. Relocatable Programs 

a. DOS-Ill Disc Monitor (DISCM) 

b. DOS-Ill Exec Modules 

c. DOS-Ill Job Processor (JOBPR) 

d. DOS-Ill Disc Driver (DVR31) 

e. DOS-HI System Console Driver (DVROO, DVR05 or DVR26) 

f. DOS-Ill Paper Tape Reader Driver (DVR01) 

Software Options 

In addition, the following programs can be included when DOS-Ill is generated: 

1. DOS-Ill Relocating Loader 

2. DOS-Ill Assembler 

3. DOS-Ill FORTRAN Compiler 

4. RTE/DOS FORTRAN IV Compiler 

5. RTE/DOS FORTRAN IV Compiler - 10K Compiler Area 

6. RTE/DOS ALGOL Compiler 

7. RTE/DOS Relocatable Library (EAU, or floating point) 

8. RTE/DOS FORTRAN IV Library (extended-precision arithmetic) 
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9. RTE/DOS FORTRAN Formatter 

10. DOS-Ill Standard Drivers (either main-memory or disc resident): 

Paper Tape Punch Driver (DVR02) 

Digital Plotter Driver (DVR10) 

Card Reader Driver (DVR11) — uses DMA or Dual Channel Port Controller 

Line Printer Driver (DVR12) 

Optical Mark Reader Driver (DVR15) 

Magnetic Tape Driver (DVR23) — uses DMA or Dual Channel Port Controller 

Terminal Printer Driver (DVR26) 

Writable Control Store Driver (DVR33) — uses DMA 

Card Reader Punch Driver (DVR34) 

Hardwired Serial Interface Driver (DVR67) 

11. DOS-Ill Physical Drivers 

Synchronous Data Set Interface Driver (DVR70) 
Synchronous Modem Interface Driver (DVR71) 
Asynchronous Data Set Interface Driver (DVR72) 
Asynchronous Multiplexer Interface Driver (DVR73) 
Buffered Asynchronous Data Set Interface Driver (DVR74) 

12. DOS-Ill Logical Drivers 

Asynchronous Terminal Driver Number One (ATD01) 
Asynchronous Terminal Driver Number Two (ATD02) 
Asynchronous Card Reader Driver Number One (ACR01) 
Page Mode Terminal Driver Number One (PMT01) 
Page Mode Terminal Driver Number Two (PMT02) 
Synchronous Line Control (SLC) 

13. DOS-Ill Extended File Management Package 

14. RTE/DOS Fast FORTRAN Processor Subroutine Library 
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SECTION II 
DOS-Ill Directives 



Directives are the direct line of communication between the keyboard or batch input device and 
DOS-Ill. Directives may enter DOS-Ill in two modes: keyboard and batch. In either mode, all 
directives are listed on the system console. Certain directives can be used in one mode only; others 
can be used in both modes. In keyboard mode, the operator manually inputs the directives through 
the system console keyboard. In batch mode, the programmer prepares the directives (commonly 
on punched cards, paper tapes, or magnetic tape) and inputs them along with programs, data, etc., 
in a complete job. 



FORMAT FOR DIRECTIVES 

Directives have the same format, regardless of the mode in which they occur: a colon (:) followed 
by a directive word (first two characters are significant) and, if necessary, a list of parameters 
(maximum is 15) separated by commas. For example, 

:PURGE,FILE1 ,FILE2,FILE3 

When the sequence and position of parameters is significant, missing parameters must be represented 
by commas if the following parameters are to be recognized. The first blank character not preceded 
by a comma is the end of the directive. Comments may appear after this blank; they are ignored by 
DOS-Ill. 

Note: The total length of an input string cannot exceed 72 characters. 



ENTERING DIRECTIVES 

DOS-Ill has two conventions for notifying the operator that directives may be entered : 

1. DOS-Ill outputs a "commercial at" sign (@) and rings a bell (at the system console). At this 
time, the operator may enter any directive. 
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DOS-Ill outputs an asterisk (at the system console). At this time the operator may enter an 
"operator attention" directive only. The "operator attention" directives are 

ABORT 

DN 

EQ 

LU 

OFF 

PAUSE 

TRACKS 

TYPE 

UP 

Should the operator type any other directive, DOS-Ill outputs the following message: 

IGNORED 



and returns to the executing program. 

To attain control of DOS-Ill (to enter an "operator attention" directive) the operator can 
strike any system console keyboard key. If the system console is available, DOS-Ill immediately 
outputs an asterisk (*); if the system console is busy, DOS-Ill will output the asterisk as soon 
as it releases the system console. 

Notes: 1. Operator attention is disabled during the completion phase of .EDIT and 
during : PURGE. 

2. Some system conditions restrict allowable directives; e.g., after an I/O 
ERR NR EQT# nn, the system is waiting for an :UP,nn, followed by :GO. 
Under such conditions, otherwise legitimate directives will be ignored. 

3. Some operations, such as editing, require perceptible waits while DOS-HI 
processes the directive. 



ORDER OF DIRECTIVES 

The DOS-Ill directives described in this section are presented in alphabetic order (by function name). 
If a directive must be used in keyboard mode only, a note to that effect is placed at the top of each 
page describing the directive. A quick cross-reference index of DOS-Ill directives, "Summary of 
Directives," is included at the back of this manual. 
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Keyboard Mode Only 



ABORT 



Purpose 

To terminate the current job before the next JOB or EJOB directive. 

Format 

: ABORT 

Comments 

Abort carries out all the operations of a batch mode EJOB directive. All I/O devices are cleared. 
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BATCH 

Purpose 

To switch from keyboard mode to batch mode, or to reassign the batch device. 

Format 

■.BATCH, logical unit 
where logical unit is the logical unit number of the desired batch input device. 

Comments 

A BATCH, JOB, TYPE, OR TRACKS directive must be the first directive entered following 
system start. 

See "TYPE" in this section for the opposite procedure of returning batch mode to keyboard 
mode. Assigning a null device or logical unit numbers 2 or 3 as the batch device results in an 
ILLEGAL LUN error (see LOGICAL UNIT directive). 
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CLEAR 

Purpose 

To clear the Job Binary Area on the disc, or to issue a clear command to an I/O device. 

Format 

: CLEAR [, logical unit] 

where logical unit is the logical unit number of the device to be cleared. If logical unit is omitted, 
the disc Job Binary Area is cleared. 

Comments 

Using logical units 1, 2, or 3 results in an LU error. 

The effect of clearing an I/O device is the transmittal of a clear function to the appropriate driver. 
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COMMENT 



Purpose 

To print a message on the system console. 

Format 

.■COMMENT character string 
where character string is a message to be printed on the system console. 

Comments 

A space (but not a comma) is required between the directive word and the comment string. 

The programmer can use : COMMENT or : PAUSE to send a message to the operator at the system 
console; using : COMMENT causes no suspension of processing. Use :PAUSE when a processing 
delay is desired, for example to request that the operator mount a magnetic tape. 

EXAMPLES: 

.COMMENT BEGINNING OF PA YROLL JOB 
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Keyboard Mode Only 



DATE 



Purpose 

To set the date and time for accounting purposes whenever DOS-Ill is activated. 

Format 

:DATE,day [,hour,min] 

where day is any string of ten or fewer characters (commas not permitted) chosen by the operator 
(such as 7/10/69, 10.JULY.69, etc.); 

hour and min are the current time in hours and minutes on a 24-hour clock. If not given or 
a Time-base Generator is not present, they are set to zero. 



Comments 

The DATE directive is legal only as the first directive in a start-up procedure. The directive is not 
accepted any other time. 



EXAMPLES: 

DATE,7/10/69,12,23 
DA TE, WEDNESDA Y,7,45 
DATEJ0JULY1969 
DA„ 
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DOWN 



Purpose 

To declare an I/O device unavailable for use during the remainder of a job. 

Format 

:DN,n 
where n is the equipment table entry number for the device to be set down. 

Comments 

The system console and the disc (logical units 1, 2, and 3) cannot be set down. 
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DUMP (DISC-TO-DISC) 



Purpose 

1. To dump an entire disc onto another subchannel (:DD) 

2. To dump the System Area (including system buffer) onto another subchannel (:DD,X) 

3. To dump all or specified files of the User Area (optionally assigning some new file names) onto 
another subchannel (:DD,U ...) or, onto the current subchannel (assigning new file names). 

Formats 

1. :DD 

2. :DD,X 

3. :DD, U[,file 1 [, (file A)] ,file 2[, (file B)] ...] 

where X specifies the System Area, 

U specifies the User Area, 

file 1, file 2, ... specify the files to be dumped (the entire User Area if no files are specified), 

file A, file B, ... specify the optional new names for file 1, file 2, etc. (renamed files can be 
intermixed with unchanged files). 

Note: No more than 1 4 parameters can be specified after :DD, U. 



The destination disc must be specified by a : UD immediately following the :DD. Any other direc- 
tive will negate the :DD. (For :DDand :DD,X, the directive must be :UD,*,n where n is not the 
system disc.) 
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Comments 

When the destination for a :DD,U is a system disc, other than the current system, the user files are 
dumped in the User Area following the system files. This allows the user to dump a system and 
selected user files to a single disc. (See also "INITIALIZE") 

The SS directive does not apply to :DD. 

If the files of the source disc cannot completely fit on the destination disc, DOS-IH transfers as 
many whole files as possible and outputs 

TRAC#TOOBIG 

If DOS-Ill cannot find some of the files specified to be dumped, the message 

file 
UNDEFINED 

is output. This does not effect dumping of the files which are defined. 

If a file specified to be dumped has the same name (after the optional renaming) as an existing file 
on the destination disc, the message 

file 

DUPLICATE FILE-NAME 

is output and the file is not dumped. This does not effect dumping of other files. 



Caution: A DOS-Ill system created through the :DD directive 
(disc-to-disc dump) cannot be protected with the 
Protect/Override switch on the disc drive because the 
protect bits on the system portion of the original disc 
are not copied during the dump operation. 
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DUMP (FILE) 



Purpose 

To dump a user file to a specified peripheral I/O device in a format appropriate to the file content. 



Format 

:DUMP,logical unit,file[,Sl [,S2]] 

where logical unit is the logical unit number of output device to be used for the dump 
file is the user file to be dumped 
SI and S2 are the first and last relative sectors to be dumped 

If SI and S2 are not given, the entire file is dumped. If only SI is given, then the file, starting with 
SI, is dumped. 



Comments 

Files may be dumped on list devices or punch devices (including magnetic tape). The dump format 
varies with the type of file and the type of device. See Table 2-1. 



Table 2-1. : DUMP Formats 



File Type 



Punch Device 



List Device 



ASCII data 
Binary data 
Absolute binary 
Relocatable binary 

Source statements 



64 characters/record 

64 words/record 

Absolute binary records 

Relocatable binary 
records (loadable) 

1 statement/record 



64 characters/record 
8 octal words/line 
8 octal words/line 
8 octal words/line 

1 statement/line 



Note: Sector numbers on listings are not related to the SI and S2 parameters. 
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Source statements are packed and do not necessarily start on sector boundaries. Thus, if the SI and 
S2 parameters are used, dumping begins with the start of the first statement beginning in sector SI, 
and ends with the last statement beginning in sector S2 (this will probably end in the following sector). 

Files in the System Area cannot be dumped. 

An error message occurs when SI > S2, or when either SI or S2 is greater than the length of the file. 

Source statements, relocatable binary and absolute binary files can be dumped to a punch device and 
later restored by using the appropriate STORE directive. In general, however, this cannot be done 
with ASCII data and binary data files. 

EXAMPLES: 



Where L is a source file. 
















:DUMP,1,L 

A 

BB 






























CCC 
















DDDD 
















EZFEE 
















FFFFFF 
















GGGGGGG 

@ 
















Where SSERH is a binary file: 














(On the system console:) 














:DU,6,SSERH,1,1 

@ 

(On the list device:) 


























001 000000 


062125 


072121 


114535 


010010 


010075 


010156 


010100 


002400 


052100 


026014 


026036 


062006 


042154 


072023 


114535 


010025 


010076 


010077 


010006 


010153 


114535 


010033 


010076 


010077 


010101 


010117 


102501 


002002 


026056 


062006 


072046 


114535 


010050 


010123 


010076 


010127 


010124 


010006 


010122 


114535 


010056 


010076 


010077 


010126 


010153 


036006 


036006 


036006 


036121 


026003 


114535 


010071 


010076 


010077 


010106 


010120 


114535 


010074 


010074 


000006 


000022 


000002 


000001 


000000 


020116 


047524 


020106 


047525 


047104 


020120 


051117 


043522 


040515 


020103 


047515 


050114 


042524 


042504 


000005 


000011 


000000 


000000 


000016 


000002 


1 77746 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


000003 


1 77777 


020040 


020501 


040440 


020040 


041102 


041040 


020040 


041503 


041440 


020040 


042104 


042040 


020040 


042505 


042440 


020040 


043106 


043040 


020040 
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DUMP (PROGRAM) 



Purpose 

To request that a user program be dumped to the standard list device (logical unit 6) when it com- 
pletes execution. Two directives are provided: PDUMP for dumping on a normal completion, and 
ADUMP for dumping when the program aborts. 



Format 

:PDUMP[,FWA[,LWA]] [,B] [,S] 
:ADUMP[,FWA[,LWA] ] [,B] [,S] 

where FWA is the octal address, relative to the program origin, of the first word to be dumped 
LWA is the octal address, relative to the program origin, of the last word to be dumped 
B means dump the base page linkage area of the program 
S means dump the entire system area. 

If LWA is missing, the entire program, starting with FWA, is dumped. B alone dumps all the main 
program, plus base page linkages, but not the system routines. S alone dumps only the system. 

If no parameters are given, everything except the system area is dumped. 



Comments 

The dump directives, PDUMP and ADUMP, must precede the RUN or PROG request in a job. They 
implicitly refer to the next program to be executed. DOS-Ill sets a flag when it encounters either 
PDUMP or ADUMP, then checks the flag the next time a program is executed. Only one of the 
requests will be honored, depending upon whether the program runs normally or is aborted. The 
dump is labeled accordingly. These flags are cleared when a program terminates. 

Any parameter following S in the directive is ignored. If FWA is greater than LWA, this message is 
output: 

LIMIT ERROR 
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The main program and library subroutines are dumped eight octal words per line, along with the 
octal starting address for that line. For example, 



adr 8 


wd-1 


wd-2 


wd-3 


wd-4 


wd-5 


wd-6 


wd-7 


wd-8 


adr 8 +10 8 


wd-1 


wd-2 


wd-3 


wd-4 


wd-5 


wd-6 


wd-7 


wd-8 



If present, the base page dump follows the main program and library. Base page linkages exist for 
page boundary crossings and subroutines. For each line, the starting octal address appears first, 
followed by four pairs of octal numbers. The first number of each pair records the content of the 
base page word (an address elsewhere in main memory). The second number of each pair records the 
contents of the address specified by the first item. If the first item is the address of a subroutine, then 
the second item contains the last address from which the subroutine was called. For example, 



adr 
adr+4 



pair-1 



pair-2 



pair-3 



item-1 
item-1 



item-2 
item-2 



item-1 
item-1 



item-2 
item-2 



item-1 
item-1 



item-2 
item-2 



pair-4 



item-1 
item-1 



item-2 
item-2 



Note: .OFF before a program executes clears the dump flags. 
:OFF during a program execution causes an abort dump. 
.OFF during a dump terminates the dump. 



EXAMPLE: 



:ADUMP,0,15,B (Set up dump flag) 
:R UN,PRG9,6 (Run program) 
LU 012140 



(Main 


program dump) 














ADUMP 
















12000 


160001 


002002 


130573 


170574 


006004 


160001 


002003 


026012 


12010 


130575 


170576 


006004 


160001 


1 70577 


006004 


160001 


1 70600 


(Page Eject) 
















(Base page dump) 














00570 


010137 


002045 


010711 


003237 


010763 


002045 


017014 


000300 


00574 


01 7641 


000000 


017015 


000400 


01 7641 


000406 


01 7601 


000000 


00600 


01 7650 


000000 


017615 


000000 


01 7664 


000000 


01 7662 


000573 


00604 


017637 


000573 


01 7571 


1 77205 


01 7563 


001204 


017714 


017715 


00610 


01 7562 


021121 


01 7534 


021122 


01 7536 


021122 


01 7633 


160656 


00614 


01 7544 


037626 


01 7546 


037626 


017673 


000000 


01 7605 


000040 
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DUMP (SECTOR) 



Purpose 

To dump any specified sector or sectors of the current user disc on the standard list device (logical 
unit 6) in either ASCII or octal format. 



Format 

:SA,track,sector[,number] (ASCII) 
: SO, track, sector [, number] (OCTAL) 

where track and sector give the starting disc address for the dump 

number gives the number of sectors to be dumped. If number is absent, only one sector is 
dumped. 

All three parameters are decimal numbers. 



Comments 

The ASCII dump format (:SA) is 64 characters per record. The octal dump format (:SO) is eight 
octal numbers per line. Two ASCII characters equal one computer word (also represented by one 
octal number). Although :SA dumps 64 characters per record, these do not necessarily appear on 
one line since the binary numbers are converted to ASCII characters, some of which might be 
linefeeds or returns. 
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EXAMPLE: 



(On the system console:) 
: SO, 0,1 

@ 

(On the list device:) 
001 



000000 


067767 


017570 


067744 


077743 


017613 


017613 


017613 


017613 


064120 


007004 


077310 


064117 


044055 


160001 


044051 


010072 


073773 


053774 


077761 


053775 


077762 


077304 


044056 


160001 


001 727 


013733 


073305 


050060 


027460 


053763 


027445 


067304 


044066 


037310 


027415 


027505 


044052 


160001 


023773 


033774 


1 70001 


063773 


073302 


002004 


073303 


063774 


073773 


067304 


160001 


073766 


164000 


017570 


063305 


050060 


027440 


006004 


160001 


033773 


1 70001 


006004 


063730 


1 70001 


006004 


003004 


1 70001 


067304 


077311 


027440 


060154 


001 722 


013765 


033774 


001727 


001 723 


070154 


063761 


067302 


017606 


063762 


067303 


01 7606 


002400 


067774 


01 7606 


063311 


067775 


01 7606 


067761 


006003 


027540 


044055 


160001 


023774 


033302 


1 70001 


067762 


006003 


027546 


023775 


033303 


1 70001 


063776 


001200 


067777 


006003 


002004 


064155 


070155 


0541 75 


070175 


006400 


0501 75 


064115 


074200 


047740 


074157 


0641 75 


074161 


124003 


000000 


057766 


127570 


037766 


163766 


002021 


027571 


013764 
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EDIT 

Purpose 

To perform listed edit operations on a user source file (follows the :SS condition). 

Format 

: EDIT, file, logical unit[,new file] 

where file is the name of a source file (the primary file) to be edited according to an edit list (edit 
operations plus associated source statements) input on the specified logical unit. If new file 
appears, the edited source file is stored in a new file (with the name new file) on the same 
subchannel and the old file is not purged. Otherwise, the edited source file destructively 
replaces the old file. (Follows :SS in searching for duplicate file names.) 

Comments 

An edit list consists of one or more edit commands and, optionally, a series of associated source 
statement (i.e., following REPLACE, INSERT). Edit operations are executed when they are 
entered. When using the system console, the operator must not enter the next operation until the 
"@" prompt is output on the console. 

All edit operations begin with a slash(/), and only the first character following the slash is required. 
The rest are ignored (until a comma is reached). 

In the edit operation formats, the letters m and n are the sequence numbers of the source statements 
to be edited, starting with one. Letter m signifies the starting statement, and n is the ending 
statement of the operation, inclusively. In all cases, n must be greater than or equal to m; 
neither can be less than one, nor greater than the last source statement of the file. The m must be 
greater than the n of the previous operation. Sequence numbers refer to the original sequence of 
the unedited file; inserted statements cannot be referenced until the current editing process is com- 
pleted and the file automatically resequenced prior to another EDIT directive. 

Source statements following /REPLACE or /INSERT on the current batch device cannot contain a 
colon (:) in column 1, although those entered from the system console can, with the exception of 
:OFF and : ABORT (which are interpreted as directives instead of data). Source statements can 
never contain a slash (/) in the first column. Source statements on any device other than the system 
console and the current batch device can contain anything else in column 1 (including :OFF or 
:ABORT). 

Input is terminated only by an /END. 
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If the edit file is entered on the system console and either a 

PARAMETER ILLEGAL 

or 

NO SOURCE 

error occurs, the user merely re-enters the statement in error. If the edit list is entered on any other 
device, the EDIT directive is aborted (if the EDIT directive was entered in keyboard mode) or the 
entire job is aborted (in batch mode). 



EDIT OPERATIONS 

/DELETE, m[,n] 

Deletes source statements m through n, inclusively, from the source file. If only m is specified, 
that one statement is deleted. 

/INSERT, m 

Inserts the source statements in the edit list immediately following this command into the primary 
file following statement m. 

/MERGE [,k] secondary file[,m[,n] ] 

Merges source statements from the secondary file into the primary file named in the EDIT directive. 

k is the sequence number of the primary file (named in the EDIT directive) after which 
source statements of the secondary file are merged. If k=0, the secondary file source state- 
ments are merged at the beginning of the primary file; if k is omitted, the secondary file 
source statements are merged at the end of the primary file. 

Secondary file is the name of the source file to be merged with the primary file. If 
m and n are specified, then only lines m through n of the secondary file are merged. 
If only m is specified, then only that one line is merged. 

/REPLACE, m[, n] 

Replaces source statements m through n (inclusively) in the primary file with source statements 
following the /R in the edit list. If n is omitted, then only statement m is replaced. 

Note: Directives cannot be inserted or replaced but can be merged from 
another file. 
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/SUPPRESS 

Suppresses echoing of the edit operations on the system console, providing that the logical unit 
specified in the EDIT directive was not the system console. Normally, echoing occurs after each 
EDIT directive unless /S is entered. 

/UNSUPPRESS 

Resumes echoing of the edit operations on the system console. 

/END 

Terminates the edit file and returns DOS-Ill to its previous mode for further directives. (The last 
edit command must be /END.) 

EXAMPLES: 

If a file named SOURC contains: 

Statement 1 ASMB,R,B,L 
Statement 2 NAM START 

Statements A EQU 30 

Statement 4 B EQU 20 

Statement 5 START NOP 
Statement 6 LDA A 

Statement 7 END 

and the EDIT directive is 

:EDIT,SOURC,5 

and the edit list, which follows .EDIT on the batch device, is 

/R,3 

A EQU 100 

B NOP 

ID, 4 

11,6 



STAB 



IE 
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then the new file SOURC equals: 



Statement 1 
Statement 2 
Statement 3 
Statement 4 
Statement 5 
Statement 6 
Statement 7 
Statement 8 



ASMB,R,B,L 

NAM START 
A EQU100 

B NOP 

START NOP 

LDAA 

STAB 

END 



Assume now that there exists a source file named FILE2: 



Statement 1 
Statement 2 



ALF,ALF 
JMP START 



To merge FILE2 into the new SOURC, the following EDIT directive, along with its edit 
list, is required: 

:ED,S0URC,5 
/M,7,FILE2 

IE 

The new file SOURC looks like this: 



Statement 1 
Statement 2 
Statement 3 
Statement 4 
Statement 5 
Statement 6 
Statement 7 
Statement 8 
Statement 9 
Statement 1 



ASMB,R,B,L 

NAM START 

A EQU100 

B NOP 

START NOP 

LDAA 
STAB 
ALF,ALF 
JMP START 
END 
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END-OF-FILE 



Purpose 

To write an end-of-file mark on a magnetic tape. 

Format 

:EF[, logical unit] 
where logical unit is the logical unit number of the desired magnetic tape (default is 8). 
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END-OF-JOB 



Purpose 

To terminate the current job normally and return to keyboard mode. 

Format 

:EJOB 



Comments 

The EJOB directive outputs a message recording the total run time of the job and execution time, 
then returns to keyboard mode. 

If :SS condition is active, :EJOB purges temporary files on all specified user subchannels. If :SS 
condition is not active, :EJOB purges temporary files on the current user subchannel. (See STORE 
directive and "DOS-Ill Relocating Loader," Section V.) All directives except :TRACKS, :OFF, 
:TYPE or : BATCH are ignored until the next JOB directive. 

:EJOB resets logical units 1 through 9 and resets the :SS condition. :EJOB resets the user disc 
assignment to the standard subchannel unless that subchannel is not ready or a new cartridge has 
been inserted (with a different label and without a UD directive). 

When the EJOB directive occurs, a message is printed, similar to that of : JOB, giving the total run 
time of the job and total execution time (if a Time-base Generator is present). For example, 

END JOB START RUN = 0007 MIN. 52.6 SEC. EXEC = 0001 MIN. 21.0 SEC. 

or 

END JOB START 

This message is printed on the system console and on the standard list device (logical unit 6). A 
top-of-form is issued on the list device prior to the message. 
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EQUIPMENT TABLE 



Purpose 

To list one or all entries in the equipment table on the system console (see Appendix A for equip- 
ment table format). 



Format 

:EQ[,n] 

where n, if present, indicates the one entry to be listed. 
If n is absent, the entire equipment table is listed. 



Comments 

Each entry is output in the following format: 

EQT nn CH vv DVRmm dr UuSs 

where nn is the decimal number of the entry 

vv is the octal channel number of the device 

mm is the I/O driver number for the device 

d specifies DMA if equal to D, no DMA if zero 

r specifies main-memory resident if equal to R, disc-resident if zero 

u is a single decimal digit used for subchannel addressing 

s is the availability status of the device: 

for not busy, and available, 

1 for disabled (down), 

2 for busy 
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EXAMPLE: 

Following is a listing of a DOS-Ill Equipment Table. 



: EQ 


















EOT 


01 


CH 


1 1 


DIM 5 




R 


U0 


so 


EOT 


02 


CH 


13 


DVR0 1 








U0 


S0 


EOT 


03 


CK 


1/! 


DVR31 


D 


■-"' 


fJ0 


so 


EOT 


0/i 


CH 


16 


DVR02 





R 


U0 


so 


EOT 


5 


CH 


20 


DVR 1 2 





R 


U0 


S0 


EOT 


06 


CK 


21 


DVR 1 1 


D 





00 


so 


EOT 


07 


CH 


02 


DVR 2 3 


D 


a 


U0 


c; r.\ 
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Keyboard Mode Only 



GO 



Purpose 

To resume a program that has been suspended, and optionally, to transfer up to five parameters to 
that program. 



Format 

:GO[,P v P 2 ,...P 5 ] 
where P through P g are optional parameters and must be decimal values between and 32767. 

Comments 

When a program suspends itself (see "Program Suspension" in Section III), it is restarted by a GO 
directive. Upon return to a suspended program, the initial address of the five parameters is located 
in the B register. A FORTRAN program calls the library subroutine RMPAR to transfer the 
parameters to a specified 5-word array. The first statement after the suspend call, in a FORTRAN 
program, must be the call to RMPAR. For example, 

DIMENSION I (5) 
CALL EXEC (7) 
CALL RMPAR (I) 

An assembly language program should use the B register upon return from the suspend to obtain 
and save the parameters prior to making any EXEC request or I/O request. 
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Keyboard Mode Only 



INITIALIZE 



Purpose 

To label or unlabel the current user disc, and to destroy an existing System Area (and, optionally, a 
User Area). 



Format 

: IN, label 

where label is a six-character name to be written on the disc, or "*" which means unlabel the 
disc. 



Comments 

Four basic cases are possible: 

1. :IN, * An unlabeled disc (a disc containing only a User Area). The user directory and all 
user files are destroyed. 

2. :IN,* A labeled disc. The message 

DOS (or TSB) LABEL xxxxxx 
OK TO PURGE? 

is output. To purge both the System and User Areas, the operator must respond with 
YES 

If the existing label is SYSTEM (the disc contains a DOS or TSB system), the Override/Protect 
switch must be in the override position (if the disc was created using DSGEN); otherwise, a 
HLT 31 will occur. If the operator responds with 

NO 
the directive is ignored. 
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3. :IN,label An unlabeled disc. Only the label is changed; no files are destroyed. 

4. :IN,label A labeled disc. The message 

??? LABEL xxxxxx 
OK TO PURGE? 

is output. To purge an existing DOS or TSB system, move the user files to the beginning of 
the disc, and assign the new label to the User Area, respond with 

YES 

If the existing label is SYSTEM (the disc contains a DOS or TSB system), the Override/Protect 
switch must be in the override position (if the disc was created using DSGEN); otherwise, a 
HLT 31 will occur. If the operator responds with 

NO 
the directive is ignored. 

Initialization does not affect the protect bits. They remain set. 

Refer to Section VI for an example of how to copy the System from one subchannel to 
another. 
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JOB 



Purpose 

To initiate a user job and assign it a name for accounting purposes. 

Format 

: JOB [, name] 

where name is a string of up to five characters (starting with a non-numeric character) which 
identifies the job. 

Comments 

A JOB, BATCH, TYPE, or TRACKS directive must be the first directive entered following system 
start. 

When DOS-Ill processes the JOB directive, it issues a top-of-form to the list device (logical unit 6), 
prints an accounting message on the system console and the list device recording the job's name 
(as specified in the JOB directive), the date (as specified in the DATE directive), and the current 
time (if a Time-base Generator is present). 

For example, 

:JOB,START 

JOB START MON 6.16.9 TIME = 0013 MIN. 41.6 SEC. 

or 

JOB STAR T MON 6.16.9 

If an EJOB directive has not been encountered, : JOB also acts as the :EJOB for the previous job. 
In this case, all actions of the :EJOB are carried out (except for returning to keyboard mode from 
batch mode) before starting the new job. 
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LIST 



Purpose 

To list file information recorded in the user or system directories; or to list and sequentially number 
the contents of all or part of a source file. 



Format 

(System) :LIST,X,logical unit[,file 1 ,...] 
(Unaffected by :SS) 

(User) :LIST, UJogical unit[,file 1 ,...] 

(Lists the specified directory entries from all the subchannels defined by :SS.) 

(Source) : LIST, S, logical unit, file[,m[,n] ] 
(follows :SS) 

where X specifies the System Area directory 

U specifies a User Area directory 

S specifies a user source file 

logical unit specifies the list device 

fitej , . . . names up to 13 entries to be listed (if none is specified, the entire directory is 
listed) 

m and n, if present, specify the first and last statements to be listed. If n is absent, then 
all statements beginning with m are listed. If neither appear, then the entire file 
is listed. The restrictions for m and n are the same as those for the EDIT directive. 



Comments 

A top-of-form is issued to the list device prior to listing. 
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DIRECTORY LISTING OUTPUT 

The first line is a heading, identifying the information that follows: 

NAME TYPE SCTRS DISC ORG PROG LIMITS B.P. LIMITS ENTRY FWAM PB 
SUBCHAN = n 

The following lines are then printed: 

name type sctrs trk sec lower upper lower b upper b entry fwam p-b 

where name identifies the file, 

type tells what kind of file name is 

AB = absolute binary program 

AD = ASCII data 

BD = binary data / User File Only 

RB = relocatable binary program 

SS = source statements 



LB = library 

XS = supervisor module 



System File Only 



DR = disc resident I/O driver 

UM = user main program ( Either File 

US = user program segment 

sctrs is the number of sectors in the file, 

trk is the track origin of the file, 

sec is the starting sector of the file within the track specified. 

The information below does not appear for types AB, AD, BD, LB, RB, and SS. 

lower is the lower limit (octal) of the program, 

upper is the upper limit (octal) of the program, 

lower b is the upper limit (octal) of the program base page links, 

upper b is the upper limit (octal) of the program base page links, 

entry is the absolute octal address where execution begins, 

fwam is the octal address of the first word of available memory following the 
program, and 

p-b is equal to T if the file is temporary and will be purged by :EJOB unless stored by 
:STORE,P. 
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If the requested file does not exist, a message appears: 
file UNDEFINED 

SOURCE LISTING OUTPUT 

Each source statement is preceded by a four-digit decimal sequence number. 

If the requested file is not a source file, the following message appears, 

file 
ILLEGAL 

The list is terminated by the message 

**** LIST END **** 



EXAMPLES: 

(on the system console:) 
:LI,U,6 

@ 

(On the list device:) 

NAME TYPE SCTRS DISC ORG PROG LIMITS B.P. LIMITS ENTRY FWAM PB 
SUBCHAN=4 



EX9 


SS 


00080 


T001 


000 


EXM 


RB 


00063 


T004 


008 


BBB 


SS 


00001 


T006 


023 


SRCH 


RB 


00003 


T007 


000 


SSERH 


UM 


00002 


T007 


003 10000 10271 


ASCII 


AD 


00200 


TOO 7 


005 


BINRY 


BD 


00300 


T015 


013 



00713 00713 10000 10271 T 



Note: T in the "PB" column means that the entry is temporary. 
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(On the system console.) 

:ST,P (To make all temporary files permanent.) 

@ 

:LI,U,6 

@ 



(On the list device:) 
NAME TYPE SCTRS DISC ORG PROG LIMITS B.P. LIMITS ENTRY FWAM PB 



SUBCHAN=4 








EX9 


SS 


00080 


T001 


000 


EXM 


RB 


00063 


T004 


008 


BBB 


SS 


00001 


T006 


023 


SRCH 


RB 


00003 


T007 


000 


SSERH 


UM 


00002 


T007 


003 10000 10271 


ASCII 


AD 


00200 


T007 


005 


BINRY 


BD 


00300 


TO 15 


013 



00713 00713 10000 10271 



Note: "PB" no longer equals T. 

(On the system console:) 
:LI,S,6,EX1 9,926,936 



(On the list device:) 
0926 ASMB,L,R,X,C,N,B 



0927 




HED DUMMY $LIBR AND $LIBX FOR RTS SIMULATION ON DOS 


0928 




NAM DUMRX,6 




0929 




ENT $LIBR,$LIBX 




0930 




SPC2 




0931 


* 


CALLING SEQ UENCES: ENTR Y 


TERMINATION 


0932 


* 






0933 


* 






0934 


* 


PRIVILEGED JSB $LIBR 


JSB $LIBX 


0935 


* 


NOP 


DEF (PROGRAM ENTR Y POINT) 


0936 


* 








**#* 


LIST END **** 
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LOGICAL UNIT 



Purpose 

To assign logical unit numbers (4 through 63) for a job or to list the device reference table (logical 
unit assignments) on the system console. 



Format 

:LU[, ni [,n 2 ]] 

where n 1 and n 2 (if present) are decimal numbers. 

If neither n 1 nor n 2 is present: the entire device reference table is printed. 

If only n x is present: the equipment table entry number assigned to logical unit number 
n 1 is printed. (See EQUIPMENT TABLE directive.) 

If both n t and n 2 are present (and n 2 does not equal zero): the device recorded in equipment 
table entry n 2 is assigned to logical unit n 1 . 

If both n 1 and n 2 are present (and n 2 does equal zero): the logical unit specified by n 1 
becomes a null device, and any I/O request on that device is ignored. 



Comments 

Assignments made by :LU for logical units 4 through 9 are only valid during the current job. 
Assignments for 10 and above remain after EJOB. At the beginning of each new job, the device 
reference table for the first nine logical units is reset to the assignments given when the system was 
generated. This insures a standard I/O organization for all users. 

If n 2 =0 (that device is to be made null), the logical unit specified by n 1 may not be equal to 1, 2, 
3, or the logical unit number of the current batch device. 
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EXAMPLE: 



:LU 

LU01 EQT03 

LU02 EQT01 

LU03 EQT01 

LU04 EQT05 

LU05 EQT04 

LU06 EQT06 

LU07 EQT07 

LU08 EQT02 

LU09 EQTOO 
@ 



(null device) 



:LU,9,5 (Logical unit 9 becomes punch) 

:DU,9,FILE1 (Dumps FILE1 to punch) 



:LU,9 
LU09 

@ 



EQT05 



(Checks EQT for LU9) 



:LU,6,0 (Assigns line printer to null device) 

:PR,FTN4,99 (Reads from paper tape reader, no list, object to JBIN) 
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MMGT 

Purpose 

To reserve logical memory address space for specific subsystems. 

Note: This directive applies to memory associated with system programs only. 
Memory associated with user programs is strictly under program control. 

In addition, this directive may be used to obtain a report of memory space previously reserved for 
subsystems. 



Format 

:MMGT[,subsystem-name p wwwwwp subsystem-name 2, WWWW2, ■ ■ ., subsystem-name 
wwwww n ] 

subsystem-name is a 4-character ASCII name defined for a subsystem at system generation. 
wwwww is the number (decimal) of logical words to be reserved for the associated subsystem. 

If no parameters are entered, the directive is interpreted as an inquiry request and a list of subsystem 
names and the number of reserved words previously set is printed on the console. The list appears in 
the following form: 



SUBSYSTEM 
subsystem-name j 
su bsys tem-name2 



WORDS 

wwwww2 

wwwww2 



subsystem-name n 



WWWWWy 
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Comments 

The :MMGT directive is entered just prior to the :PROG or :RUN directive and reserved memory 
space is released at program termination. If the subsystem name specified was not defined at system 
generation, the system prints: 

subsystem-name — UNDEFINED 

where subsystem-name is the 4-character subsystem name. Any defined subsystem names is included 
in the parameter string are accepted. 

If an attempt is made to update or display the subsystem table and no subsystems were defined 
when the system was generated, the system prints: 

NO SUBSYSTEMS DEFINED 

If the cumulative sum of words requested for subsystems exceeds the amount available, the system 
prints: 

LIMIT ERROR 

Any requests up to the available space limit are accepted. If more than one subsystem name is in- 
cluded in the parameter string, the user may determine which requests have been accepted by enter- 
ing the :MMGT directive with no parameters. This causes a list of subsystem names together with 
the number of words reserved for each name to be printed on the console. 



Note: The subsystem names discussed here must be included as entry points 
(ENT) within the associated subsystem routines which are included as 
part of the system at generation time. 
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Keyboard Mode Only 



OFF 



Purpose 

To abort the currently executing user program or system operation without terminating the job. 

Format 

.OFF 

Comments 

:OFF returns the system to keyboard mode. 

:OFF can be used to terminate undesired lists, edits, disc-to-disc dumps, program loops, Loader 
operations, assemblies, and compilations. 

:OFF cancels any pending DD, ADUMP, or PDUMP directives, unless a program is running, in 
which case, a pending : ADUMP is executed. 
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PAUSE 



Purpose 

To interrupt the current job, optionally print a comment on the system console, and return to the 
system console for operator action. 



Format 

:PA USE [character string] 

Comments 

PAUSE may be entered through the keyboard even when DOS-Ill is in batch mode. PAUSE suspends 
the current job until the operator inputs a GO directive. During this time the operator may mount 
magnetic tapes or prepare I/O devices. (A series of COMMENT directives or a remark in the 
PAUSE directive itself can be used to tell the operator what to do during the PAUSE.) 

The GO directive returns DOS-Ill to the job in the previous mode. 

EXAMPLE: 

:PA USE MOUNT MAG TAPE (Operator mounts magnetic tape) 
:GO 



2-38 



PROGRAM 



Purpose 

To turn on (i.e., load from the disc and begin executing) a program from the System Area or a 
program from the User Area which was generated with the DOS-Ill Relocating Loader. (Follows 
the :SS condition in searching for the program.) 



Format 

:PROG,name[,P 1 ,P 2 , . . . P s ] 

where name denotes a system program, such as FTN for the DOS-M FORTRAN Compiler, 
FTN4 for the RTE/DOS FORTRAN IV Compiler, ASMB for the DOS-M Assembler, 
LOADR for the DOS-Ill Relocating Loader, or ALGOL for the RTE/DOS ALGOL 
Compiler. 

A user program is specified via the file name assigned by the DOS-Ill Relocating 
Loader (the name specified in the program's PROGRAM, HPAL, or NAM statement). 

Pj through P s are optional parameters which DOS-Ill transfers to the program named. 
Pj through P 5 must be positive integers less than 32767. The program must retrieve 
the parameters immediately. This procedure is described under :GO. 



Comment 

Consult Section V for the parameters required by FTN, FTN4, ASMB, ALGOL, and LOADR. 
Additional programs may be added during system generation, if desired. 

Note: User programs can be run using :PROG or :RUN. :PROG is useful when 
the program needs parameters. DOS-HI first searches the user files for 
the program, then the system files. :RUN is useful when an execution 
time limit is desired (and a Time-base Generator is present). 



EXAMPLES: 



:PROG,FTN,2,99 
:PROG,MYFIL,0,3,84 
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PURGE 

Purpose 

To remove the directory entry associated with a user file. (Follows the :SS condition.) 

Format 

■.PURGE [jilejjilep ... 7 

where filej,file2, . . . (up to 15 file names or 72 characters per directive) designate files in the 

User Area. The directory entry for the specified file name is purged (marked for removal) 

If no file names are given, all directory entries for temporary files are purged. 

Comments 

After the directory entries are purged, the remaining User Area files may be repacked for efficiency 
by entering the :RPACK directive. However it should be noted that the repacking function is per- 
formed automatically each time an :EJOB directive is executed. 

If the end of the User Area moves below a track boundary during the purge, the Work Area becomes 
a track larger. As each file's directory entry is purged, DOS-Ill prints its name on the system 
console. 

The presence of undefined files in the list has no effect on the purging of named (and existing) 
entries. However, if an entry cannot be found, this message is output to the system console: 

file UNDEFINED 

The fastest way to purge all files on a single disc is to use :IN,* (see "Initialize" in Section 2). 

CA UTION: OPERA TOR A TTENTION IS DISABLED D URING :PUR GE. 
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EXAMPLE: 



Original contents of user directory: Fl, F2, F3, F4, FLONG, and F5 (at least) 

Directive: :PURGE,FLONG,Fl,F2,D3,D7,F3,F4,F5 
Output: FLONG 
Fl 
F2 

D3-- UNDEFINED 

D7-- UNDEFINED 

F3 

F4 

F5 
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RENAME 



Purpose 



To rename a specified user file and, optionally, change its program type. (Follows the :SS 
condition.) 



Format 

:RNAME,oldname,newname[, type] 

where oldname is the name of the user file to be renamed 
newname specifies the new name for the file 
type specifies the new type for the file. 

Comments 

If a file name on one of the active subchannels is the same as newname, the message 

DUPLICATE FILE NAME 

is output and the file name is not changed. If the file named oldname cannot be found on any of 
the active subchannels, the message 

oldname UNDEFINED 

is output. 

The type parameter must be a decimal number from 3 to 12. File types 3-5 require 11-word 
directory entries and types 6-12 require 5- word directory entires. If the file type is incompatible 
in this respect, a 

PARAMETER ILLEGAL 

message results. (File type numbers are described in Appendix A.) 

Note: It is the users responsibility to insure that the format and structure of 
the file contents are compatible with its new file type. 



2-42 



REWIND 



Purpose 

To rewind a magnetic tape. 

Format 

:RWND[, logical unit] 
where logical unit is the logical unit number of the desired magnetic tape (default is 8). 
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RPACK 



Purpose 

To repack the disc, eliminating purged files. 

Format 

:RPACK 



Comments 

When a : PURGE directive is issued, the directory entry for specific or implied files is purged. The 
: RPACK directive is used to search the directory for purged entries. If any are detected, the user 
file area is repacked, eliminating those files. 



Note: This repacking function is automatically performed at the end of 
each job. 



EXAMPLE: 

.RPACK 

scans the user directory for purged entries and repacks the disc to eliminate files 
associated with those entries. 
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RUN 

Purpose 

To run a user or system program. (Follows the :SS condition.) 

Format 

:R UN,name[, time] f,NJ 

where name is a user file containing the desired program 

time is an integer specifying the maximum number of minutes the program may run 
(default is five minutes). DOS-Ill ignores time if a Time-base Generator is not present. 

N, if present, tells DOS-Ill to allow the program to continue running even if it makes 
EXEC calls with illegal request codes. 

Comments 

Programs which have been relocated during the current job but not stored (see STORE directive) 
permanently in a user file, may be run using this directive. 

If a program executes longer than the time limit, the current job is aborted and DOS-Ill scans to 
the next JOB directive. 

If N is not present in the RUN directive, the current job will be aborted by any illegal request codes. 
The N option is provided so that programs can be written and tested on DOS-Ill ultimately to exe- 
cute with other HP software not having the same request codes. 

EXAMPLE: 

: RUN, ROUT, 15 

executes program ROUT up to fifteen minutes, not allowing illegal request codes. 



TM 13421 

@ 

System responds, indicating a time-out condition. 
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SPECIFY SOURCE FILE 



Purpose 

To specify the user source file to be used as input by the Assembler and compilers. (Follows the 
:SS condition.) 



Format 

:JFILE,file 
where file is the name of a source file on any active subchannel. 

Comments 

If logical unit 2 is specified as the input device when the compiler or Assembler is turned on (using 
:PROG) and a : JFILE has been defined, then the compiler or Assembler reads the source statements 
from the : JFILE. 

Only one program can be translated from a file; any statements beyond the end of the source pro- 
gram will be ignored. The JFILE assignment is only valid for the current job, and can be reassigned 
by another JFILE directive. 

When using a 21MX Assembler, up to fifteen files may be specified in the : JFILE directive so long 
as these files constitute one program having one END statement. 

It is highly recommended that the JFILE directive immediately precede the corresponding PROG 
directive. 

Example 3 in Section VI illustrates using the JFILE directive. 
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STORE 



Purpose 

To create a user file on the current user disc and assign it a name. The STORE directive can create 
relocatable object program files (type-R), loader-generated object program files (type-P), source 
statement files (type-S), ASCII data files (type-A), binary data files (type-B), and absolute binary 
program files (type-X). (Follows :SS in checking for duplicate file names.) 



Format 

The format varies according to what type file is being created. See Comments below for details: 



TYPE-R 
TYPE-P 
TYPE-S 
TYPE-A 
TYPE-B 
TYPE-X 



STORE,R,file[,logical unit] 
STORE,P[,file l ,file 2 ...] 
STORE, SJ lie, logical unit [,C] 
STORE, A,i Hie, sectors 
STORE,B,file,sectors 
STORE, X,file,logical unit 



Note: Control @ should not be used in file names. 



Comments 

TYPE-R FILES. The directive format is 

: STORE, R,f He [, logical unit] 

where file is a name consisting of five (or fewer) characters and must not duplicate another 
name already present in the user files. 
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A user file is created under this name, and relocatable binary programs are read into it from the 
logical unit specified or from the Job Binary Area of the disc if none is specified. The Job Binary 
Area remains as it was before the STORE,R directive. 

If DOS-Ill comes to an end-of-tape, it asks: 

DONE? 

If there are more tapes, the operator places the next tape in the reader and replies NO; otherwise, 
he answers YES. 



EXAMPLES: 

:STORE,R,RINE 

(Stores all of the relocatable programs from the Job Binary Area into the file RINE 
created for that purpose.) 

:STORE,R,JUGG,5 

(Stores relocatable programs from logical unit 5, the standard input device, into the 
file JUGG.) 



TYPE-P FILES. The directive format is 

: STORE, P[, name j ,name 2 ,....] 

where name 1 ,name 2 ... are programs that the DOS-Ill Relocating Loader had relocated into 
executable format during the current job. A program is stored in a file of the same 
name. Up to 14 programs per directive are allowed. If none are specified, all programs 
loaded during the current job are stored. DOS-Ill finds these temporary programs in 
the user file and converts them to permanent user files by removing their "temporary" 
flags (see the description of the LIST,U directive). 

Programs loaded during the current job but not stored as permanent files (as shown above) may be 
executed normally (RUN or PROG directive) and appear in the user file directory. At the end of a 
job, however, they are purged from the directory unless they have been converted to user files by 
a STORE,P directive. 
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EXAMPLES: 

:STORE,P 



(Changes all programs loaded during the current job using the Relocating Loader into 
permanent user files.) 

:STORE,P,ARITH,MA TH, TRIG,ALGEB 

(Searches for the programs listed and makes them permanent user files.) 



TYPE-S FILES. The directive format is 

:STORE,S,file,logical unit [,C] 

where file is the name of the user file to be filled with source statements from the logical unit 
specified. File is a name of five or fewer characters, and must not duplicate a name 
already present in the user files. The source statement input must be terminated by a 
record containing a double colon (::) if the C option is omitted; or a triple colon (:::) if 
the C option is included. If the termination record is omitted, DOS-Ill stores the succeeding 
data on the disc as if it were source statements. 

If DOS-Ill comes to an end-of-tape before finding the termination record (:: or :::), it outputs 

DONE? 
on the system console. 

If there are more tapes, the operator replies NO; otherwise, he answers YES. 
When DOS-Ill completes the STORE,S it outputs 

nnnn LINES 

where nnnn is the number of statements stored. 

If the C parameter is included in the STORE directive, statements with a colon in column 1 are 
interpreted as data and transferred to the designated source file. In this case, input is terminated 
with a triple colon (:::). When the C parameter is omitted in the STORE directive, those statements 
with a colon in column 1 will attempt execution. The logical unit specified in the STORE, S direc- 
tive (when the C parameter is used) must not be the current batch device logical unit. If it is, 
DOS-Ill outputs the message 

ILLEGAL LUN 



2-49 



If the user is in keyboard mode, DOS-Ill outputs an @ and waits for a new directive. If the user is 
in batch mode, a batch abort occurs. 

If the C parameter is used and the logical unit specified is the system console, then all input received 
prior to : : : is transferred to the designated source file, except OFF and ABORT directives. If 
either of the two are encountered during keyboard entry, they are interpreted as directives and 
executed. (:OFF returns control to keyboard mode without terminating the job. :ABORT aborts 
the current job if the directive was entered from the keyboard, or DOS-Ill performs a batch abort 
if the STORE, S directive was entered from the batch device.) Files containing :OFF and : ABORT 
can be created by storing from a device other than the system console or the current batch device. 



EXAMPLE: 

:STORE,S,SOURC,5 

(Reads source statements from the standard input device and stores them in a new file 
SOURC.) 



TYPE-A AND TYPE-B FILES. The directive format is 

: STORE, type,file,sectors 

where type is either A (for ASCII character data) or B (for binary data), and file is the name 
assigned to a file containing the number of sectors requested. These requests are made 
prior to executing a program to reserve a file area; no data is involved. 

The program must store and retrieve data from the file through a call to EXEC. It is the programmer's 
responsibility to store the right kind of data in the file. The EXEC call must specify the file name 
and the relative sector within the file. DOS-Ill checks only that the file name exists and that it 
contains the sector specified. 



EXAMPLE: 

:STORE,A,ASCII,20 

(Creates a file name ASCII, 20 sectors in length. A sector equals 128 sixteen-bit 

words. ) 
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TYPE-X FILES. The directive format is 

:STORE,X,file,logical unit 

where file is the name of the user file to be filled with absolute binary programs from the device 
specified by logical unit. 

When an end-of-tape is encountered, DOS-Ill outputs 

DONE? 

To continue loading tapes, place the next tape in the reader and type NO; otherwise, type YES. 
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Optional Directive 



SYSTEM SEARCH 



Purpose 

To specify a list of disc subchannels which may be searched for file names. This is the :SS condition 
which applies to all EXEC calls and directives that require a file search. (No check is made for 
existing duplicate file names during searches; the first file found is used.) 



Format 

:SS 

:SS,n 1 ,n 2 ,n 3 .... 



All active subchannels are searched, starting with the current user subchannel, 
then continuing from the highest to the lowest number. 

Where n 1 ,n 2 ... are subchannel numbers. The current user subchannel is 
searched first, then the subchannels specified, starting with the lowest 
number. 



:SS,99 



Only the current user subchannel is searched. This is the default condition. 
Every job starts out in this condition. 



Comments 

The SS directive can only be used if it was specifically allowed during system generation. (See 
"Generating and Loading DOS-Ill," Part 3.) Otherwise, any SS directive will cause the following 
message: 

BAD CONTROL STATE 

If a file search results in the file being found, the current user subchannel is changed to the sub- 
channel containing the file. If the file was not found, the current user subchannel is restored to 
its previous assignment 

The LIST,U, file directive is an exception: this directive does not stop after it finds the file; it con- 
tinues to look for duplicate entries. When the LIST search is complete, the original user subchannel 
is always restored. 
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However, if a search is interrupted before completion, the current user disc may be on any sub- 
channel. (This should be checked with a :UD directive.) 

More than one : SS can occur during a job. The job starts in : SS,99 condition until a different SS 
directive is issued. Each SS directive remains in effect until another is issued. SS directives do not 
apply to file searches initiated by the Relocating Loader or to disc dumps initiated by the DD 
directive. 

Whenever the user subchannel assignment is changed (except by a running program through the 
appropriate EXEC call), the system outputs a message: 

SUBCHAN = n 



EXAMPLE: 

:UD 

SUBCHANNEL = 1 

LABEL = UNLBL 

: RUN MYPRG 

FILE NAME UNDEFINED (file not on subchannel 1) 

:SS (search all subchannels for file MYPRG) 

:RUN 

SUBCHANNEL = 

(MYPRG now begins execution) 



2-53 



TOP-OFFORM 



Purpose 

To issue a top-of-form command to a list device. 

Format 

:TOF[, logical unit] 

where logical unit is the logical unit number of the desired list device. If logical unit is omitted, 
then logical unit 6 receives the command. 
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TRACKS 



Purpose 

To output information about the next available track on the current user disc. 

Format 

: TRACKS 

Comments 

A TRACKS, JOB, BATCH, or TYPE directive must be the first directive entered following system 
start. 

The decimal number corresponding to the first track beyond the end of the current user area (and 
the number of faulty tracks encountered, if any) is output to the system console. 

Faulty tracks are replaced by spares when parity errors occur on read or write. 

EXAMPLES: 

The following is an example in which no faulty tracks are reported. 

(INPUT) : TRACKS 

(O UTPUT) NEXT A VAIL TRA CK = 0010 

@ (End of directive processing) 

In this example, the system reports that 2 tracks have been replaced by spares. 

(INPUT) : TRACKS 

(O UTPUT) NEXT A VAIL TRA CK = 0012 

BAD = 2 

@ (End of directive processing) 
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In this example, the system reports that there are no more tracks available in the user area. 

(INPUT) .TRACKS 

(O UTPUT) NEXT A VAIL TRA CK = NONE 

@ (End of directive processing) 
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TYPE 



Purpose 

To return from batch mode to keyboard mode. 

Format 

:TYPE 

Comments 

A TYPE, JOB, BATCH or TRACKS directive must be the first directive entered following system 
start. 

Control is returned to the system console. :TYPE may be entered through the batch device or the 
keyboard device; when it is entered from the keyboard, DOS-HI waits until the currently executing 
program is completed or is aborted before returning to keyboard mode. If :TYPE is entered while 
already in keyboard mode, the directive is ignored. 
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UP 



Purpose 

To declare an I/O device ready for use. 

Format 

:UP,n 
where n is the equipment table entry number corresponding to the device. 

Comments 

The UP directive (followed by a :GO) is usually used in response to one of the following messages 
from DOS-Ill: 

I/O ERR ET EQT #n 
I/O ERR NR EQT #n 
I/O ERR PE EQT #n 

where ET indicates end of tape, 

NR indicates device not ready, 

PE indicates parity error, and 

n is the equipment table entry number. 

If the incorrect n is entered, DOS-Ill outputs a list of all the down devices. 
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USER DISC CHANGE 



Purpose 

To change the subchannel assignment for the user disc. 

Format 

:UD[,[label][,n]] 

where label is a six-character disc label (* for an unlabeled disc) 
n is the new subchannel. 

Comments 

Discs are labeled by the INITIALIZE directive. 

Each form of the UD directive has a different purpose. 

EXAMPLES: 



:UD 

(without label 
or subchannel) 



:UD„n 
(no label) 



:UD, label, n 



Interrogates the current user disc subchannel and outputs its 
label on the system console: 

SUBCHAN = n 

LBL = label (or UNLBL) 

If n is labeled, DOS-HI outputs 
LBL = label (or UNLBL) 
No assignment is made. 

If n is labeled with the specified label, DOS-HI assigns n as the 
user disc. If n is unlabeled or has a different label, DOS-HI 
outputs 

LBL = label (or UNLBL) 

Operator can then reissue :UD,label,n with the correct label. 
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:UD, label DOS-Ill searches for the label, starting with the highest number 

(no subchannel) subchannel (determined at system generation). If label is found, 

DOS-Ill makes it the user disc and outputs 

SUBCHAN = n 

If label is not found, DOS-HI outputs 

DISC NOT ON SYS 

: UD, *,n If n is unlabeled, DOS-Ill assigns n as the user disc. 

If n is labeled, DOS-IH makes no assignment and outputs 
LBL = label 

: UD, * Assigns the highest number unlabeled disc as the user disc 

and outputs 

SUBCHAN = n 

If there are no unlabeled discs, DOS-HI outputs 

DISC NOT ON SYS 

If the UD directive specifies a subchannel with an incorrect system proprietary code (see "Disc 
Labels" in Appendix A), DOS-Ill still makes the assignment, and outputs 

TSBDISCor ??? DISC 

If the UD directive specifies a subchannel whose system generation code does not match that of the 
current system disc, DOS-Ill still makes the assignment but outputs 

DISC GEN CODE nnnn NOT SYS GEN CODE mmmm ERR POSS 

The changes made by :UD are only temporary; the user disc is reset at the end of each job. 

Notes: 1. Before executing a :DD or :DD,X to a TSB or ??? DISC, the disc should 

be initialized with : IN,*; otherwise, bad tracks may be reported erroneously. 

2. If a disc pack is changed on a DOS-Ill system, the subchannel assigned to 
that pack must be explicitly reassigned using a : UD directive or EXEC call. 

Refer to item 5 in Section VI for an example of copying a System from one subchannel to another. 
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SECTION III 
DOS-Ill EXEC Calls 



DOS-Ill EXEC calls are the line of communication between an executing program and DOS-Ill. 
An EXEC call is a block of words, consisting of an executable instruction and a list of parameters 
defining the request. The execution of the instruction transfers control to DOS-Ill. DOS-Ill then 
determines the type of request (from the parameter list) and, if it is legally specified, initiates 
processing of the request. 

In FORTRAN, EXEC calls are coded as CALL statements. In ALGOL, procedure calls are used. 
In Assembly Language, EXEC calls are coded as a JSB EXEC, followed by a series of parameter 
definitions. For any particular call, the object code generated for the FORTRAN CALL Statement 
and the ALGOL procedure call is equivalent to the corresponding Assembly Language object code. 

This section describes the basic formats of FORTRAN, ALGOL and Assembly Language EXEC 
calls; presents each EXEC call in detail; and concludes with a discussion of how parameters are 
passed to and from a program. 

The EXEC calls detailed in this section are presented alphabetically, according to their function. 
The Request Code (RCODE) value they have in the Assembly-language calling sequence appears 
at the top of each page. 



Note: DOS-Ill may include two user-created EXEC modules, loaded along with 
the DOS-HI system EXEC modules during system generation. The pur- 
pose of the EXEC modules (called $EX36 and $EX37) and the number 
of parameters needed in the EXEC call are defined by the user. User EXEC 
module calling sequences are defined in Section XII, "User-written EXEC 
Modules. " 
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ASSEMBLY LANGUAGE EXEC CALLS 

The following is a general model of an EXEC call in Assembly Language: 
EXT EXEC (Used to link program to DOS-Ill) 



JSB EXEC 
DEF *+n+l 

DEFPj 

DEFP n 
return point 



(Transfer control to DOS-Ill) 

(Defines point of return from DOS-Ill, n is number of 
parameters; may not be an indirect address; must be the 
location immediately following the last parameter 
address) 

(Define addresses of parameters which may occur any- 
where in program; may be multi-level indirect. Seven is 
the maximum number of allowable parameters for any 
EXEC call.) 

(Continue execution of program) 



(Actual parameter values) 
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ALGOL EXEC CALLS 

In ALGOL, certain conventions must be followed in making EXEC calls. First, since EXEC is 
external to the program it must be declared a CODE procedure. Second, parameters that are 
going to be changed must not be declared VALUE. Third, when arrays are passed as parameters, 
the first element of the array (not just the array name) must be passed as a type INTEGER and 
not by VALUE. Fourth, since ALGOL requires that the format of each procedure call be defined, 
a program must declare a dummy external procedure for each EXEC call requiring a different 
number of parameters. (These dummy procedures must be compiled as separate procedures to 
provide proper linkage in the Loader.) 



EXAMPLE: 

The program below (DXFER) reads one sector from the work area and writes the 
information into a different location in the work area. DXFER calls EXEC through 
the CODE procedure EXECX (compiled externally). EXECX is compiled in the program 
DSKIO, although that program name is irrelevant to the linkage between DXFER and 
EXECX. 

MAIN PROGRAM 

HPAL,B,L,"DXFER" 
BEGIN 

INTEGER ARRAY B UFFER [1 : 1 28] ; 

BOOLEAN READX; 

INTEGER TRACK,SECTOR; 

FORMAT Fl ("SOURCE TRACK,SECTOR?"), 

F2("DESTINATION TRACK,SECTOR ?"); 
PROCEDURE EXECX(RD,TRK,SCTR,BFR); 
VALUE RD,TRK,SCTR; 
BOOLEAN RD; 
INTEGER TRK,SCTR,BFR; 
CODE; 
WRITE(1,F1); 

READ(1 , * TRA CK,SECTOR); 
READX^TRUE; 

EXECX(READX,TRACK,SECTOR,BUFFR[l]); 
WRITE(1,F2); 

READ(l*,TRACK,SECTOR); 
READX^FALSE: 

EXECX(READX, TRACK,SECTOR,BUFFR[l] ); 
END$ 
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PROCEDURE 

HPAL,P,B,L, "DSKIO" 

PROCEDURE EXECX(RD,TRK,SCTR,BFR); 
VALUE RD,TRK,SCTR; 
BOOLEAN RD; 
INTEGER TRK,SCTR,BFR; 
BEGIN 

PROCED URE EXEC(IO,LU,BFR,BFSZ, TRK,SCTR); 
INTEGER IO,LU,BFR,BFSZ,TRK,SCTR; 
CODE; 
INTEGER REQCD; 

IF RD THEN REQCD^l ELSE REQCD<-2; 
EXEC(REQCD,2,BFRJ28,TRK,SCTR); 
END; 
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FORTRAN EXEC CALLS 

In FORTRAN, the EXEC call consists of a CALL Statement and a series of assignment statements 
defining the variable parameters of the call: 

CALL EXEC (P,,P ,. . . ,P ) 

where P t through P n are either integer values or integer variables defined elsewhere in the program. 



EXAMPLE 

CALL EXEC (7) 

} Equivalent calling sequences 

IRCDE —7 



CALL EXEC (IRCDE) 



Some EXEC call functions are generated automatically by the FORTRAN compiler or special sub- 
routines. (Refer to "FORTRAN," in Section V and the specific EXEC calls in this section.) 
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RCODE = -19 



BASE PAGE STORE 



Purpose 

To store values into base page memory locations. 

Assembly Language 

EXT EXEC 



LDA NUMB 
LDB ADDR 
JSB EXEC 
DEF *+2 
DEF RCODE 
return point 



(Transfer control to DOS-Ill) 
(Point of return from DOS-Ill) 
(Request code) 
(Continue execution) 



RCODE DEC -19 
NUMB DEC n 
ADDR DEF LOC 



(Request code = -19) 
(n is value to be stored) 
(LOC is a base page location) 



FORTRAN 



This feature must not be invoked by a FORTRAN program. 



Comments 

Base Page Store stores values into base page locations normally protected by memory protect. 
Prior to using the calling sequence specified above, the user loads the value to be stored into the 
A register and the absolute address of the base page location in the B register. Base Page Store then 
performs a store indirect through the B register. 

CA UTION: CARE MUST BE TAKEN NOT TO MODIFY SYSTEM-ESSENTIAL 
BASE PA GELOCA TIONS. 
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RCODE=32 



FILE CREATE 

Purpose 

To allow the user to create a user disc file under program control. 



CAUTION: Because of the relationship between disc space used for the work area 
and disc space used for creating new files, care must be taken to create 
all files before issuing requests that access the disc work area (work 
area limits requests, disc allocation requests, work area I/O requests). 



Assembly Language 






EXT 


EXEC 




JSB 


EXEC 


(Transfer control to DOS-HI) 


DEF 


*+6 


(Point of return from DOS-Ill) 


DEF 


RCODE 


(Request code) 


DEF 


RSTAT 


(Return status) 


DEF 


FNAME 


(File name) 


DEF 


TYPE 


(Program type) 


DEF 


DSKLN 


(File length) 


return 


point 


(Continue execution) 



RCODE DEC 32 
RSTAT BSS 1 



(Request code = 32) 
(Return status from system: 
-4 = illegal parameter 
-3 = invalid file name 
-2 = invalid file type 
-1 = insufficient file space 

= normal termination 
>0 = duplicate file name — content is 
address of old directory entry) 
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RCODE=32 



FNAME ASC 3,xxxxx 
TYPE OCT nnnnnn 



DSKLN DEC s 



(5-character file name) 
(Program type: 

bit 7 = 0; permanent 
= 1 ; temporary 
bits 5-0 = 6-14 8 ; program type as defined 
in Disc Directory "Entry Type, " 
Appendix A) 
(Length in sectors) 



FORTRAN 



DIMENSION INAM(3) 
INAM(l) = xxxxxB 
INAM(2) = xxxxxB 
INAM(3) = xxxxxB 
ITYPE = n 
IDSK = s 
IRCDE = 32 



(File name) 
(First two characters) 
(Next two characters) 
(Last character and blank) 
(n is numeric program type) 
(s is disc length in sectors) 
(Request code) 



CALLEXEC(IRCDE,IRST,INAM,ITYPE,IDSK) 



EXAMPLE: 



DATA NAME/2HDA,2HIL,2HY/ 



C CREATE TEMPORARY ASCII FILE OF 72 SECTORS 
CALL EXEC(32,LSTAT,NAME,213B,72) 
IF (LSTAT .NE. 0) GO TO error routine 
continue normal program path 
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RCODE = 18 



FILE NAME SEARCH 



Purpose 

To check whether a specific file name exists in the directory of user or system files. (Follows the 
:SS condition.) 



Assembly Language 

EXT EXEC 



JSB 


EXEC 


(Transfer control to DOS-Ill) 


DEF 


*+4 (or 5) 


(Point of return from DOS-Ill) 


DEF 


RCODE 


(Request code) 


DEF 


FNAME 


(File name) 


DEF 


NSECT 


(Number of sectors) 


DEF 


IPRAM 


(Optional parameter) 


return 


point 


(Continue execution) 



RCODE DEC 18 

FNAME ASC 3,xxxxx 
NSECT NOP 

IPRAM DEC n 



(Request code = 18) 

(xxxxx is the file name) 

(Number of sectors returned here; if not 

found) 

n = user area with wait 

n = 1 user area without wait 

n = 2 system area with wait 

n = 3 system area without wait 
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RCODE = 18 



FORTRAN 




DIMENSION NAME (3 


IPRAM 


= 2 


IRCDE 


= 18 


NAME (1) 


%A* v\* *A- 1\ •A* J-J 


NAME (2) 


^^ *Y* 'V* 'Y* \* *\p LJ 


NAME (3) 


•^ *\r *Ar *\ *Ar JU 



(File name) 

(System search, with wait) 

(Request code) 

(First two characters) 

(Next two characters) 

(Last character and blank) 



CALL EXEC (IRCDE, NAME, ISECT, IPRAM) 



Comments 

File searches can be performed on either the system or user area, with or without wait, according 
to the value of IPRAM. If IPRAM is omitted, the search is performed on the user area with wait. 
If the search is requested with wait, the A register contains the track/sector address of the file, and 
the B register contains the memory address of the track/sector address, upon return to the user 
program. 

Before executing a File Name Search without wait, NSECT should be initialized to some value 
other than zero (for example, -1) to distinguish between "file not found" and "operation still in 
process" conditions on completion of the search. EXEC calls issued while the File Name Search is 
still in progress are queued by DOS-Ill and the system goes into the wait loop until the search is 
completed. 



EXAMPLE: 

EQUIVALENCE (AREG,IREG(1)) 
DATA NAME/2HFI,2H1/ 



AREG = EXEC(18,NAME,ISECT,0) 
IF (ISECT .NE. 0) GO TO error routine 
IREG(l) = track /sector address of the file 
ISECT = number of sectors in FILE1 

Note: The FORTRAN function variable (AREG) is a copy of the 
A-register or the A- and B-registers. 
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RCODE=33 



FILE PURGE 

Purpose 

To allow the user to purge a user disc file directory entry or to purge all temporary file entries. 

Assembly Language 

EXT EXEC 



JSB EXEC 
DEF *+3 (or 4) 
DEF RCODE 
DEF RSTAT 

DEF FNAME 
return point 



(Transfer control to DOS-Ill) 
(Point of return from DOS-Ill) 
(Request code) 
(Return status) 
(Optional file name) 
(Continue execution) 



RCODE DEC 33 
RSTAT BSS 1 



FNAME ASC 3,xxxxx 



(Request code = 33) 
(Return status from system: 
-4 = illegal parameter 
-3 = invalid file name 
-1 = undefined file name 
= normal termination 

(5-character file name) 
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FORTRAN 



RCODE=33 



DIMENSION INAME(3) 
INAME(l) = xxxxxB 
INAME(2) = xxxxxB 
INAME(3) = xxxxxB 
IRCDE = 33 



(File name) 
(First two characters) 
(Next two characters) 
(Last character and blank) 
(Request code = 33) 



CALL EXEC(IRCDE,IRST,INAME) 



Comments 

If the file name parameter is omitted, all temporary file entries are deleted from the directory. 
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RCODE = 14, RCODE = 15 



FILE READ/WRITE 



Purpose 

To transfer information to or from a file on the user disc; the file must be referenced by name. 
(The :SS condition is followed.) 



>ly Language 






EXT 


EXEC 




JSB 


EXEC 




DEF 


*+7 (or 8) 




DEF 


RCODE 




DEF 


CONWD 




DEF 


BUFFR 




DEF 


BUFFL 




DEF 


FNAME 




DEF 


RSECT 




DEF 


IPRAM 




return point 


RCODE 


DEC 


14 or 15 


CONWD 


OCT 


conwd 


BUFFR 


BSS 


n 


BUFFL 


DEC 


n or -2n 


FNAME 


ASC 


O <y "l* /y i\» <v* 
(J , tA/ *<v uv \\ vV 


RSECT 


DEC 


m 


IPRAM 


NOP 





(Transfer control to DOS-Ill) 

(Point of return from DOS-Ill) 

(Request code) 

(Control information) 

(Buffer location) 

(Buffer length) 

(File name) 

(Relative sector within file) 

(Area which could have been legally transferred 

if an overflow occurred-optional parameter) 

(Continue execution) 



(Request code: 14 = read, 15 = write) 

(See Comments, I/O READ/WRITE EXEC call) 

(Buffer of n words) 

(Same n, words (+) or characters (-)) 

(User file name = xxxxx) 

(Relative sector number) 

(Optional parameter; see Comments) 
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RCODE = 14; RCODE = 15 



FORTRAN 



DIMENSION NAME (3), IBUF(IO) 

NAME(l) = xxxxxB (First two characters of file name) 

NAME(2) = xxxxxB (Second two characters) 

NAME(3) = xxxxxB (Last character and blank) 

ICRDE =14 (or 15) (Request code) 

ICON = conwd (See comments) 

IRSCT = (Relative sector number) 

CALL EXEC (IRCDE, ICON, IBUF, 10, NAME, IRSCT, IPRAM) 

or 
CALL EXEC (IRCDE, ICON, IBUF, 10, NAME, IRSCT) 



Comments 

See the Comments under I/O READ /WRITE EXEC call (RCODE = 1 or 2) for a description of the 
conwd fields needed in the above calling sequences. 

To read or write on the mth sector of a file, set RSECT = m— 1. To determine the size of a file, use 
the FILE NAME SEARCH EXEC call (RCODE = 18). 

Data files to be written (or read) should be created with a STORE directive before executing the 
EXEC call. 

Any type of file may be read, but only ASCII or binary data files may be written. 

If the DOS-Ill installation is likely to have more than one user disc, the program should use the 
USER DISC CHANGE EXEC call (RCODE = 23) without a subchannel specified to check 
whether the correct user disc is currently assigned. Alternatively, the user can use an SS directive 
to set up a system search condition for referencing files on many subchannels. 

This call provides an optional parameter, IPRAM, to provide the user with information concern- 
ing a file read/write overflow (where the buffer length exceeds the sector contents). If IPRAM is 
omitted, an overflow causes an IT error. If IPRAM is included and an overflow occurs, control 
is returned to the user program with IPRAM set equal to the number of words (+) or characters 
(— ) (as defined by BUFFL) that could legally have been transferred. If an overflow occurs, no 
disc transfer takes place, whether IPRAM is included or not. If IPRAM is included and no over- 
flow occurs, the value of the parameter is set to zero. 



EXAMPLE: 

DATA NAME /2HFI,2HLE,2H1/ ^ 

DIMENSION IBUF(128) 

Read the first sector of FILE1. 



CALL EXEC(14,3,IBUF,128,NAME,0) 



J 
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RCODE=34 



FILE RENAME 

Purpose 

To allow the user to change a file name (and optionally, its type) under program control. 



Language 






EXT 


EXEC 




JSB 


EXEC 


(Transfer control to DOS-HI) 


DEF 


*+5 (or 6) 


(Point of return from DOS-HI) 


DEF 


RCODE 


(Request code) 


DEF 


RSTAT 


(Return status) 


DEF 


ONAME 


(Old file name) 


DEF 


NNAME 


(New file name) 


DEF 


NTYPE 


(Optional new file type) 


return 


point 


(Continue execution) 



RCODE DEC 34 
RSTAT BSS 1 



ONAME ASC 3,xxxxx 
NNAME ASC 3,xxxxx 
NTYPE OCT nnnnnn 



(Request code = 34) 
(Return status from system: 
-4 = illegal parameter 
-3 = invalid old or new file name 
-2 = invalid old or new file type 
-1 = undefined old or new file name 

= normal termination 
>0 = duplicate new file name; content 
is address of duplicate directory 
entry) 
(5-character file name to be changed) 
(5-character new file name) 
(New program type: 

bit 7 = 0; permanent 
= 1 ; temporary 
bits 5-0 = 6-1 4 8 ; program type as defined 
in Disc Directory ''Entry Type, " 
Appendix A) 
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RCODE=34 



FORTRAN 






DIMENSION IN AMO( 3), INAMN(3) 


(O/d /i"/e name, new file name) 


INAMO(l) = 


AAvVA»Vj.J 


(First two characters) 


INAMO(2) = 


xxxxxB 


(Next two characters) 


INAM0(3) = 


vv *A/ »/V •A' vv JJ 


(Last character and blank) 


INAMN(l) = 


*/v tnf */v vv *A* JLJ 


(First two characters) 


INAMN(2) = 


•^•^ vV*V*^ JJ 


(Next two characters) 


INAMN(3) = 


•A *V •A' vV *\- JLJ 


(Last character and blank) 


IRCDE = 34 




(Request code = 34) 


ITYPE = n 




(File type) 



CALLEXEC(IRCDE,IRST,INAMO,INAMN,ITYPE) 



Comments 

The specified old name may match the new name — no error message is returned, the new program 
type (if specified) will be changed. 
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RCODE=3 



I/O CONTROL 



Purpose 

To carry out various I/O control operations, such as backspace, write end-of-file, and rewind. 



Assembly Language 






EXT 


EXEC 




JSB 


EXEC 




DEF 


*+3 (or 4, or 5) 




DEF 


RCODE 




DEF 


CONWD 




DEF 


PRAM1 




DEF 


PRAM2 




return point 


RCODE 


DEC 


3 


CONWD 


OCT 


conwd 


PRAM1 


DEC 


n 


PRAM2 


BSS 


m 



(Transfer control to DOS-Ill) 
(Point of return from DOS-Ill) 
(Request code) 
(Control information) 
(First optional parameter) 
(Second optional parameter) 
(continue execution) 



(Request code = 3) 

(See Comments) 

(Optional value parameter; see "Comments") 

(Optional buffer address) 



FORTRAN 

Use the specific FORTRAN auxiliary I/O statements (see Comments) or an EXEC calling sequence. 



DIMENSION IPRM2(m) 

IRCDE = 3 

ICNWD = conwd 

IPRAM = n 

CALL EXEC (IRCDE,ICNWD,IPRAM) 

or 
CALL EXEC (IRCDEJCNWD) 

or 
CALL EXEC (IRCDE,ICNWD,IPRAM,IPRM2) 



(Define buffer of m words) 
(Request code) 
(See Comments) 
(Optional; see Comments) 
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W 


FUNCTION CODE (see below) 


LOGICAL UNIT NUMBER 


15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 






RCODE=3 

Comments 

CONWD 

The control word value (conwd) has three fields: 

BITS 

WAIT FIELD (W) 
If W = 1, DOS-Ill returns to the calling program after starting the control request. 
If W = 0, DOS-Ill waits until the control request is complete before returning. 

FUNCTION CODE FIELD 

Function codes are defined programatically within the various I/O drivers. Thus the following list 
of standard function codes is general in nature. Detailed information on specific peripheral- 
associated function codes is available in the DOS-HI Standard Drivers Reference Manual 
(24307-90073). 



Function Code 
(Octal) 

000 
001 
002 
003 
004 
005 
006 
007 
010 
011 
012 
013 
014 
017 



Action 

Clear the device (all drivers) 

Write end-of-file (magnetic tape), select hopper (optical mark reader) 

Backspace one record (magnetic tape) 

Space forward one record (magnetic tape) 

Rewind (magnetic tape), bell request (optical mark reader) 

Rewind standby (magnetic tape) 

Dynamic status (all drivers) 

Set end-of -paper tape (paper tape punch) 

Generate paper tape leader (paper tape punch) 

List output line spacing (line printers) (PARM1 or IPRAM required) 

Write file gap (magnetic tape) 

Space forward one file (magnetic tape) 

Backspace one file (magnetic tape) 

Extended function code present (card reader punch) 



For function code values 000 through 077 8 , no DMA is assigned. For function code values 100 
through 177 8 , DMA is assigned if required by the I/O driver. 



LOGICAL UNIT FIELD 

This field specifies the logical unit number of the device which is to receive the control request. 
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RCODE = 3 



OPTIONAL PARAMETERS 

Specification of Parameter, (PRAM1 or IPRAM) or Parameter (PRAM2 or IPRM2) depends on 
the contents of the function code field in the control word. Function code 11 8 requires Parameter) 
This parameter designates the number of lines to be spaced on the specified logical unit. A negative 
value specifies a page eject on a line printer or the number of lines to be spaced on the System Con- 
sole. For details on line printer formatting, refer to Section IV in the DOS-Ill Standard Drivers 
Reference Manual (24307-90073). When Parameter! is specified, its value is passed to EQT10 
prior to entering the driver. If Parameter is specified, Parameter, must be specified. The value of 
Parameter 2 is passed to the driver via EQT11. 



Compiler Considerations 

Within FORTRAN and ALGOL programs, various control operations for magnetic tape may be 
performed by the following auxiliary I/O statements: 

BACKSPACE 

ENDFILE 

REWIND 

Refer to the appropriate compiler manual for a detailed description of these statements. 



EXAMPLES: 

C CLEAR I/O DEVICES 1 TO N 
DO 10LU=1,N 
10 CALL EXEC (3,LU) 

C SPACE 5 LINES ON THE LINE PRINTER 
CALL EXEC (3J106B,-5) 

C SPACE FORWARD ONE FILE MARK 
CALL EXEC (3,1 31 OB) 

C FOR DATA COMMUNICATION - SET TERMINAL OPTION ENABLE AUTO L.F. 
CALL EXEC (3,4000B+LU,1) 
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RCODE = 1; RCODE = 2 



I/O READ/WRITE 



Purpose 

To transfer information to or from an external I/O device or the work area of the disc. (DOS-Ill 
handles track switching automatically.) 



Assembly Language 



EXT EXEC 



JSB 


EXEC 


DEF 


*+5 (or 7) 


DEF 


RCODE 


DEF 


CONWD 


DEF 


BUFFR 


DEF 


BUFFL 


DEF 


DTRAK 


DEF 


DSECT 


return point 



(Transfer control to DOS-Ill) 

(Point of return from DOS-Ill; 7 is for disc request) 

(Request code) 

(Control information) 

(Buffer location) 

(Buffer length) 

(Track number — disc transfer only) 

(Sector number — disc transfer only) 

(Continue execution) 



RCODE 


DEC 


1 (or 2) 


CONWD 


OCT 


conwd 


BUFFR 


BSS 


n 


BUFFL 


DEC 


n (or -2n) 


DTRAK 


DEC 


f 


DSECT 


DEC 


g 



(Request code: 1 = read, 2 = write) 
(conwd is described in comments) 
(Buffer of n words) 
(<n; words (+) or characters (—)) 
(Work area track number, decimal) 
(Work area sector number, decimal) 



Note: Single I/O transfers within the DOS-HI environment 
cannot exceed 16 K words. 
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RC0DE = 1;RC0DE = 2 



FORTRAN 



DIMENSION IBUF (n) 
IRCDE = 1 (or 2) 
ICON = conwd 
IBUFL = n (or -2n) 
ITRAK = 150 
ISECT = 



(Define buffer of n words) 

(Request code) 

(See Comments) 

(Buffer length in words (+) or characters (-1)) 

(Disc track number) 

(Disc sector number) 



CALL EXEC (IRCDE, ICON, IBUF, IBUFL, ITRAK, ISECT) 
CALL EXEC (IRCDE, ICON, IBUF, IBUFL) 



for disc transfers 
for non-disc transfers. 



Comments 



CONWD 

The conwd, required in the calling sequence, contains the following fields: 



BITS 









W 


J 




A 




K 


V 


M 




LOGICAL UNIT # 




15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 






FIELD 

W 



K 



V 



M 



FUNCTION 

If 1, tells DOS-Ill to return to the calling program after starting the I/O transfer. 
If W = 0, DOS-Ill waits until the transfer is complete before returning. 

If 1, and logical unit number is 2 or 3 (disc), a backward track increment will be 
performed (for example, JBIN read/write). (This field is applicable only to 
RCODE = 1 or RCODE = 2.) 



When transferring variable length binary records (M = V 
absolute binary format. 



1) 



1), A = 1 indicates 



When used with console keyboard input, if K=0 "no printing" is specified. 
If K=l printing the input as received is specified. 

2) When used with disc write requests, if K=0 execute cyclic check after disc 
write. If K=l eliminate cyclic check after disc write. 

1) When reading variable length records from punched tape devices in binary 
format (M = 1), if V = the record length is determined by buffer length. 
If V = 1, the record length is determined by the word count in the first 
non-zero character read in. 

2) When outputting ASCII records to a list device (M = 0), if V = the first 
character in the buffer is interpreted as a carriage control character (see 
Section IV). If V = 1, single spacing occurs, and the entire buffer (including 
the first character is output to the list device. 

Determines the mode of data transfer. If M = 0, transfer is in ASCII character 
format, and if M = 1, binary format. 
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RCODE = l;RCODE = 2 



'Waiting and No Waiting' 



If the program requests the "waiting" option in the conwd (W = 0), DOS-Ill will return the trans- 
mission log in the B register upon completion. (The transmission log is a positive number, repre- 
senting the number of words or characters transmitted, depending upon which was originally 
requested. ) 

If the program requests the "no waiting" option in the conwd (W = 1), it can check for the com- 
pletion of the I/O operation with the I/O STATUS EXEC call (RCODE = 13). When the operation 
is complete (STATS > 0),the transmission log can be retrieved from the TLOG parameter. 



Notes: When using "no waiting" I/O and loading program segments: 

1. Under :RUN, DOS-HI waits for all I/O to complete before loading the 
segment. 

2. Under .PROG, DOS-Ill does not wait. 

If a read or write is issued to a disc address that does not lie in the Work Area, the message IT nnnnn 
is output and the program is terminated. 



Compiler Considerations 

Within FORTRAN and ALGOL programs, I/O transfers to standard devices are programmed by 
the READ and WRITE statements. 

I/O transfers to the Work Area and the disc may be done through the BINRY library routine. The 
user must specify: an array to be used as a buffer, the length of the buffer in words (equal to the 
number of elements in an integer array, double that for a real array), the disc logical unit number, 
track number, sector number, and offset in words within the sector. (If the offset equals 0, the 
transfer begins on the sector boundary. If the offset equals N, then N words of the sector are 
skipped before starting the transfer.) BINRY has two entry points, BREAD and BWRIT, for read 
and write operations respectively. An example below gives the calling procedure. 

DIMENSION IBUF(IO), BUF(20) 

LUN = 2 

ITRK=120 

ISECT = 36 

IOFF = 

CALL BREAD (BUF, 40, LUN, ITRK, ISECT, IOFF) 

or 
CALL BWRIT (IBUF, 10, LUN, ITRK, ISECT, IOFF) 
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RCODE = 13 



I/O STATUS 



Purpose 

To request the status of a particular I/O device, and the amount transmitted in the last operation. 

Assembly Language 

EXT EXEC 



JSB EXEC 
DEF *+4(or5) 
DEF RCODE 
DEF LUN 
DEF STATS 
DEF TLOG 
return point 



(Transfer control to DOS-HI) 

(Point of return from DOS-Ill) 

(Request code) 

(Logical unit) 

(Status returned) 

(Transmission log returned, optional) 

(Continue execution) 



RCODE DEC 13 

LUN DEC n 

STATS NOP 

TLOG NOP 



(Request code = 13) 
(Logical unit number) 
(Status returned here) 
(Transmission log returned here) 



FORTRAN 



IRCDE = 13 (Request code) 

LUN = n (n is decimal logical unit number) 

CALL EXEC (IRCDE, LUN, ISTAT, ITLOG) 



Comments 

The status returned in the A register and in STATS is the hardware status of the device specified by 
the logical unit number. The transmission log in the B register and in TLOG contains the amount of 
information which was last transferred (a positive number of words or characters, depending on 
which was requested by the call initiating that transfer). 
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RCODE=38 



MEMORY MANAGEMENT 
(BUFFER ALLOCATION) 



Purpose 



To allocate buffer space within an area reserved under a block name identifier (see "Memory 
Management (Initialize)") or from unassigned available memory. 



Assembly Language 






EXT 


EXEC 




JSB 


EXEC 




DEF 


*+6 (or 7) 




DEF 


RCODE 




DEF 


RSTAT 




DEF 


LENG 




DEF 


SADR 




DEF 


ID 




DEF 


BID 




return 


point 


RCODE 


DEC 


38 


RSTAT 


BSS 


1 



LENG 


DEC 


n 


SADR 


BSS 


1 


ID 


BSS 


1 


BID 


ASC 


O ^»*y»^» yy* 



(Transfer control to DOS-Ill) 

(Point of return from DOS-HI) 

(Request code) 

(Return status) 

(Desired buffer length) 

(Buffer starting address is returned here) 

(Buffer identifier is returned here) 

(Optional block name identifier) 

(Continue execution) 



(Request code = 38) 
(Return status from system: 
-4 = illegal parameter 
-3 = BID not present 
-1 = no memory available 

= normal return 
>0 = requested amount not available; 
contents is actual number of 
words available) 
(Buffer length in words) 
(Actual starting address from system) 
(Buffer identifier from system 1 < ID < 1 023) 
(4-character unique memory management block 
name identifier) 



Comments 

If a block name identifier is specified, the buffer will be allocated space within the area reserved 
for that identifier. If the block name identifier is omitted, space is allocated from unassigned 
available memory. 
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RCODE = 41 



MEMORY MANAGEMENT 
(BUFFER RELEASE) 



Purpose 

To release reserved buffer space. 

Assembly Language 

EXT EXEC 



JSB EXEC 
DEF *+4 
DEF RCODE 
DEF RSTAT 
DEF ID 
return point 



(Transfer control to DOS-Ill) 
(Point of return from DOS-HI) 
(Request code) 
(Return status) 
(buffer identifier) 
(Continue execution) 



RCODE DEC 41 
RSTAT BSS 1 



ID 



DEC n 



(Request code = 41) 
(Return status from system: 

-4 = illegal parameter 

-1 = illegal ID 
= normal return 
(Buffer identifier 1 < ID < 1023) 



Comments 

This request releases space allocated to buffers. If the specified buffer resides within the area 
reserved under a block name identifier, the logical address space remains reserved. Otherwise, 
the released space is returned to the system. 
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RCODE = 35 



MEMORY MANAGEMENT 
(INITIALIZE) 



Purpose 

To reserve a block of memory under a block name identifier specified by the user. 



Assembly Language 








EXT 


EXEC 






JSB 


EXEC 


(Transfer control to DOS-Ill) 




DEF 


*+6 (or 7) 


(Point of return from DOS-Ill) 




DEF 


RCODE 


(Request code) 




DEF 


RSTAT 


(Return status) 




DEF 


LENG 


(Desired block length) 




DEF 


SADR 


(Block starting address is returned here) 




DEF 


BID 


(Block name identifier) 




DEF 


LADR 


(Optional starting address parameter) 




return 


point 


(Continue execution) 


RCODE 


DEC 


35 


(Request code = 35) 


RSTAT 


BSS 


1 


(Return status from system: 
-4 = illegal parameter 
-2 = another block name identifier 

assigned to area specified by LADR 
-1 = no memory available 

= normal termination 
~>0 = space requested not available; 
content is number of words 
available) 


LENG 


DEC 


n 


(Block length in words) 


SADR 


BSS 


1 


(Actual starting address of block— from system) 


BID 


ASC 


^V^lAAhl/vV 


(4-character memory management block name 
identifier) 


LADR 


OCT 


n 


(Requested starting address— = don't care) 



Note: A non-zero LADR value must be an 

address between ending program address 
and last word of available memory. 
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RCODE = 35 



Comments 

This request reserves a block of memory under the block name identifier (BID) specified by the 
user. Subsequent user requests for allocation of buffer space within this area may be made. If the 
memory management initialize request (RCODE=35) is not included in a user program prior to 
buffer allocation requests (RCODE=38) for buffers within the specified BID, an error return con- 
dition results. If LADR is specified and is non-zero, the value must be an address between the end 
of program address and the last word of available memory. 
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RCODE = 36 



MEMORY MANAGEMENT 
(STATUS REQUEST) 



Purpose 



To determine the number of words reserved under a block name identifier or the number of 
unallocated words remaining. 



Assembly Language 






EXT 


EXEC 




JSB 


EXEC 


(Transfer control to DOS-Ill) 


DEF 


(+3 (or 4) 


(Point of return from DOS-Ill) 


DEF 


RCODE 


(Request code) 


DEF 


LENG 


(Word count from system) 


DEF 


BID 


(Optional block name identifier) 


return point 


(Continue execution) 



RCODE DEC 36 
LENG BSS 1 



BID 



./ioO ^^OCOCXOC 



(Request code = 36) 

(Number of words allocated to BID or number of 
available words if BID is not present. If BID 
parameter is specified but not found, a -3 value 
is returned) 

(Unique memory management block name identi- 
fier) 



Comments 

When the BID parameter is specified, this request returns the number of words reserved under a 
user-specified block name identifier (BID). If the BID parameter is specified but not found, a -3 
value is returned. If the BID parameter is not specified, the request returns the number of unalloc- 
ated words remaining in the system. 



3-28 



RCODE = 30 



MEMORY PROTECT CONTROL 



Purpose 

To enable or disable the memory protect option from a user program. 

CA UTION: THE SYSTEM IS NOT PROTECTED WHEN MEMOR Y PROTECT IS 
IS DISABLED. 

Assembly Language 

EXT EXEC 



JSB EXEC 
DEF *+3 
DEF RCODE 
DEF MPTK 
return point 



(Transfer control to DOS-Ill) 

(Point of return from DOS-Ill) 

(Request code) 

(Define the memory protect parameter flag) 

(Continue execution) 



RCODE 
MPTK 



DEC 30 
DECn 



(Request code = 30) 

(If n = 0, memory protect is activated, and 
is activated following any interrupt 
completion. Ifn=f=0, then memory protect 
is deactivated and remains off after 
interrupt completion) 



FORTRAN 



IRCDE = 30 

MPTK = (or 1) 

CALL EXEC (IRCDE, MPTK) 



Comments 

Any program termination, either normal or aborted, enables memory protect. Program segments 
can make memory protect EXEC calls to turn memory protect on or off, but calling and exiting 
from segments has no effect on memory protect settings. 
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RCODE = 6 



PROGRAM COMPLETION 



Purpose 

To notify DOS-Ill that the calling program is finished and wishes to terminate. 

Note: Every program must terminate and return to DOS-IH using this 

EXEC call, whether the EXEC call is explicitly coded or indirectly 
generated by a compiler. 

Assembly Language 

EXT EXEC 



JSB EXEC 
DEF *+2 
DEF RCODE 



(Transfer control to DOS-Ill) 
(Define end of parameter list) 
(Request code) 



RCODE DEC 6 



(Request code = 6) 



FORTRAN 



IRCDE = 6 

CALL EXEC (IRCDE) 



Compiler Considerations 



The FORTRAN and ALGOL compilers automatically generate a PROGRAM COMPLETION EXEC 
call when they compile an END or STOP statement. 
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RCODE = 10 



PROGRAM LOAD 



Purpose 

To load a main program from the disc into main memory and transfer control to its entry point. 
Follows the :SS condition. 



Assembly Language 

EXT EXEC 



JSB EXEC 
DEF *+3(to8) 
DEF RCODE 
DEF PNAME 
DEF PRAM1 



(Transfer control to DOS-Ill) 

(Determine number of parameters) 

(Request code) 

(Program name) 

(First optional parameter) 





DEF PRAM5 


RCODE 


DEC 10 


PNAME 


J\.OLs OyXXXXX 


PRAM1 


... 



PRAM5 



(Fifth optional parameter) 



(Program name) 

(Up to 5 words of parameter information 
passed to the program. See "Parameter 
Processing" at the end of this section.) 



FORTRAN 



DIMENSION NAME(3) 

IRCDE = 10 

NAME(l) = xxxxxB 

NAME(2) = xxxxxB 

NAME(3) = xxxxxB 

CALL EXEC (IRCDE,NAME[,Pj ...] ) 



(Program name) 

(First two characters) 
(Next two characters) 
(Last character and blank) 



3-31 



RCODE = 10 

Comments 

During main program loading, the system interrogates a system flag called AEPF (location 135 ). 
This flag is normally zero unless specifically set by a user program. If AEPF is not zero, the contents 
of AEPF are treated as an alternate entry point address. The system transfers control to the alter- 
nate entry point by performing a JMP AEPF,I (jump indirect). AEPF is then cleared. If AEPF = 0, 
control transfers to the program main entry point. 

The Assembly language user can alter the contents of AEPF (and any other base page location) by 
using the BASE PAGE STORE EXEC call (RCODE = -19). 



3-32 



RCODE = 7 



PROGRAM SUSPENSION 



Purpose 

To suspend the calling program from execution until restarted by the GO directive. 

Assembly Language 

EXT EXEC 



JSB EXEC 
DEF *+2 
DEF RCODE 
return point 



(Transfer control to DOS-Ill) 
(Point of return from DOS-Ill) 
(Request code) 
(Continue execution) 



RCODE DEC 7 



(Request Code = 7) 



FORTRAN 



IRCDE = 7 

CALL EXEC (IRCDE) 



Comments 

DOS-Ill prints a message on the system console when it processes the PROGRAM SUSPENSION 
EXEC call: 

name SUSP 

When the operator restarts the program with a :GO, up to five parameters may be passed to the sus- 
pended program. (See "Parameter Processing" at the end of this section.) 
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RCODE = 7 



Compiler Considerations 

The FORTRAN and ALGOL compilers automatically generate a PROGRAM SUSPENSION EXEC 
call when they compile a PAUSE statement. 
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RCODE = 8 



SEGMENT LOAD 



Purpose 

To load a segment of the calling program from the disc into the segment overlay area and transfer 
execution control to the segment's entry point. (See Section V, "DOS-Ill Subsystems," for infor- 
mation on segmented programs.) Follows the :SS condition. 



Assembly Language 




EXT EXEC 




JSB EXEC 




DEF *+3(to8) 




DEF RCODE 




DEF SNAME 




DEF PRAM1 




DEF PRAM5 


RCODE 


DEC 8 


SNAME 


AoU xi^XXXXX 


PRAM1 


— 


PRAM5 


... 



(Transfer control to DOS-Ill) 

(Determine number of parameters) 

(Request code) 

(Segment name) 

(First optional parameter) 



(Fifth optional parameter) 



(Request code = 8) 

(xxxxx is the segment name) 

(Up to 5 words of parameter information 

passed to the segment. See "Parameter 

Processing'''' at the end of this section.) 



FORTRAN 



DIMENSION NAME (3) 

IRCDE = 8 

NAME (1) = xxxxxB 

NAME (2) = xxxxxB 

NAME (3) = xxxxxB 

CALL EXEC (IRCDE, NAME [,p t ...] ) 



(Segment name) 

(First two characters) 
(Next two characters) 
(Last character and blank) 
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RCODE = 8 



Comments 

In the FORTRAN or ALGOL calling sequence, the user must convert the name of the segment from 
ASCII to octal and store it in the NAME array, two characters per word. The RTE/DOS FORTRAN 
IV Compiler, however, can convert this automatically through Hollerith constants. 

During program segment loading, the system interrogates a system flag called AEPF (location 135 8 ). 
This flag is normally zero unless specifically set by a user program. If AEPF = 0, control transfers 
to the program segment main entry point. If AEPF is not zero, the contents of AEPF are treated 
as an alternate entry point address. The system transfers control to the alternate entry point by 
performing a JMP AEPF,I (jump indirect). AEPF is then cleared. (The Assembly language user can 
alter the contents of AEPF (and any other base page location) by using the BASE PAGE STORE 
EXEC call (RCODE = -19).) 

See "Segmented Programs," in Section V, for a description of segmented programs. 
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RCODE = 29 



SEGMENT RETURN 



Purpose 

To return control from a segment to the main program at the instruction immediately following the 
program segment load call. (This provides a subroutine-like return from a segment to a main 
program.) 



Assembly Language 

EXT EXEC 



JSB EXEC 

DEF *+2 (to 7) 

DEF RCODE 

DEF PRAM1 



(Transfer control to DOS-HI) 
(Point of return from DOS-HI) 
(Define the request code) 
(Define the first parameter) 



DEF PRAM5 



(Define the fifth optional parameter) 



RCODE DEC 29 
PRAM1 • • • 



PRAM5 



(Request code = 29) 

(Up to five words of parameter information 
are passed from the segment to the main 
program. See "Parameter Processing" at 
the end of this section) 



FORTRAN 



IRCDE = 29 

CALL EXEC (IRCDE [,P1, 



,P5]) 
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RCODE = 11 



Purpose 

To request the current time. 

Assembly Language 

EXT EXEC 



TIME REQUEST 



JSB EXEC 
DEF *+3 
DEF RCODE 
DEF ARRAY 
return point 



(Transfer control to DOS-Ill) 
(Point of return from DOS-HI) 
(Request code) 
(Time value array) 
(Continue execution) 



RCODE DEC 11 
ARRAY BSS 5 



(Request code = 11) 
(Time value array) 



FORTRAN 



DIMENSION ITIME (5) 

IRCDE = 11 

CALL EXEC (IRCDE, ITIME) 



Comments 

When DOS-Ill returns, the time value array contains the time on a 24-hour clock: 

ARRAY or ITIME (1) = Tenth of seconds 

ARRAY + 1 or ITIME (2) = Seconds 

ARRAY + 2 or ITIME (3) = Minutes 

ARRAY + 3 or ITIME (4) = Hours 

ARRAY + 4 or ITIME (5) = Not used, but must be present (always = 0) 

If DOS-Ill does not contain Time-base Generator, all values in the time array are set to zero. 
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RCODE = 17 



WORK AREA LIMITS 



Purpose 

To ascertain the first and last tracks of the Work Area on the system or current user disc and the 
number of sectors per track. 



Assembly Language 






EXT 


EXEC 




JSB 


EXEC 


(Transfer control to DOS-Ill) 


DEF 


*+5 (or 6) 


(Point of return from DOS-Ill) 


DEF 


RCODE 


(Request code) 


DEF 


FTRAK 


(First track) 


DEF 


LTRAK 


(Last track) 


DEF 


SIZE 


(Number of sectors/track) 


DEF 


DISC 


(Optional parameter — see Comments) 


return 


point 


(Continue execution) 



RCODE DEC 17 
FTRAK NOP 
LTRAK NOP 
SIZE NOP 
DISC DEC n 



(Request code = 17) 

(Returns first work track number here) 

(Returns last work track number here) 

(Returns number of sectors per track here) 

(n = for system disc; ni= for current user disc) 



FORTRAN 



IRCDE = 17 (Request code) 

CALL EXEC (IRCDE, IFTRK, ILTRK, ISIZE, IDISC) 

or 
CALL EXEC (IRCDE, IFTRK, ILTRK, ISIZE) 
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RCODE = 17 



Comments 

This call returns the limits of the Work Area, which is that area of the system or user disc which pro- 
grams use for temporary storage with the I/O READ/WRITE EXEC call (RCODE = 1 or 2). If the 
DISC parameter is omitted from the calling sequence, or if DISC = 0, the system disc information is 
returned. If DISC f 0, user disc information is returned. 
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RCODE = 16 



WORK AREA STATUS 



Purpose 

To ascertain whether a specified number of consecutive operable tracks exist in the Work Area of 
the system disc. 



Assembly Language 

EXT EXEC 



JSB EXEC 

DEF *+5 

DEF RCODE 

DEF NTRAK 

DEF TRACK 

DEF STRAK 

return point 



(Transfer control to DOS-Ill) 
(Point of return from DOS-HI) 
(Request code) 
(Number of tracks desired) 
(Starting track desired) 
(Actual starting track) 
(Continue execution) 



RCODE DEC 16 

NTRAK DEC n 

TRACK NOP 

STRAK NOP 



(Request code = 16) 

(Consecutive tracks desired) 

(Desired track; from LIMITS call) 

(Actual starting track available, if n tracks 

not available) 



FORTRAN 



IRCDE = 16 (Request code) 

NTRAK= n (Consecutive tracks desired) 

ITRAK = m (Desired starting track) 

CALL EXEC (IRCDE, NTRAK, ITRAK, ISTRK) 
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RCODE = 16 



Comments 

This call is used with the WORK AREA LIMITS EXEC call (RCODE = 17) to establish the nature 
of the Work Area. The READ/WRITE EXEC call (RCODE = 1 or 2) then transmits information to 
and from this area, using the track numbers determined by this call. DOS-Ill handles track switching 
automatically. 

DOS-Ill checks whether there are n consecutive tracks starting at the track specified. If n tracks are 
available, DOS-Ill returns the starting track number to the program. If DOS-Ill does not locate n 
consecutive tracks, it returns in STRAK or ISTRK. 
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RCODE = 23 



USER DISC CHANGE 



Purpose 

To change the subchannel assignment for the user disc. 

Assembly Language 

EXT EXEC 



JSB EXEC 
DEF *+3 (or 4) 
DEF RCODE 
DEF LABEL 
DEF SUBCH 
return point 



(Transfer control to DOS-Ill) 

(Point of return from DOS-Ill) 

(Request code) 

(Disc label) 

(Disc subchannel; optional) 

(Continue execution) 



RCODE DEC 23 
LABEL ASC 3,xxxxxx 
SUBCH DEC (0 to 7) 



(Request code = 23) 
(Label = xxxxxx) 



FORTRAN 




DIMENSION LABEL (I 


IRCDE = 


23 


LABEL (1) 


«A/»A'*A' *\**\t .U 


LABEL (2) 


vVtA'vVvVA'iJ 


LABEL (3) 


= xxxxxB 


ICHNL 


= M 



(New label) 

(First two characters) 
(Next two characters) 
(Last two characters) 
(0 through 7) 



CALL EXEC (IRCDE, LABEL, ICHNL) 

or 
CALL EXEC (IRCDE, LABEL) 
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RCODE = 23 

Comments 

If both the label and subchannel are specified, DOS-Ill checks whether the subchannel has that 
label. If it does, the assignment is made and DOS-Ill returns. If not, DOS-Ill outputs 

LBL = name (name is label on the subchannel) 

or 

UNLBL 

UD nnnnn (nnnnn = address of EXEC call) 

xxxxx SUSP (xxxxx = name of program) 

The operator can load a correctly labeled disc on the subchannel and input 
:GO 

to return to the beginning of the EXEC call (not the normal return point) so that the program can 
reissue the EXEC call. If the operator does not have a properly labeled disc (or the subchannel is 
a permanent disc), he should use :OFF or :ABORT. 

If only a label is specified, DOS-Ill searches for the label, starting with the highest subchannel. If 
DOS-Ill finds the label, it makes the assignment. If DOS-Ill cannot find the label, it suspends the 
program and outputs 

DISC NOT ON SYS 
UD nnnnn 

XXXXX o UOx 

The operator can then abort the program or load a properly labeled disc then input 

:GO 

to return to the beginning of the EXEC call. 

If the label equals "*" and a subchannel is specified, DOS-Ill checks whether the subchannel is 
unlabeled. If it is, DOS-Ill makes the assignment. If the subchannel is labeled, DOS-Ill suspends 
the program and outputs 

LBL = name 

UD nnnnn 

xxxxx SUSP (xxxxx is the program) 

The operator can then abort the program or load an unlabeled disc on the proper channel then 
input 

:GO 

to return to the beginning of the EXEC call. 
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RCODE = 23 

If the label equals "*" and a subchannel is not given, DOS-Ill searches for an unlabeled disc, starting 
with the highest subchannel. DOS-Ill assigns the first unlabeled disc as the user disc, or if no un- 
labeled discs are found, it suspends the program and outputs 

DISC NOT ON SYS 
UD nnnnn 

XXXXX o C/Oj 

The operator can then abort the program or load an unlabeled disc then input 

:GO 
to return to the beginning of the EXEC call. 



Notes: 1. If the EXEC call specifies a subchannel with an incorrect system 
proprietary code (see Appendix A), DOS-HI still makes the assign- 
ment but outputs 

TSBDISCor ??? DISC 

2. If the EXEC call specifies a subchannel whose system generation 
code (see Section VII) does not match that of the system disc, 
DOS-Ill still makes the assignment, but outputs 

DISC GEN CODE nnnn NOT SYS GEN CODE mmmm ERR POS 

3. The changes made by this EXEC call are only temporary, and will be 
reset at the end of each job to the user subchannel specified during 
system generation. 

4. If the specified subchannel is not active (physically present), DOS-HI 
suspends the programaand outputs 

I/O ERR NR USER DISC 

or 

I/O ERR PE USER DISC 

UD nnnnn (nnnnn = address of EXEC call) 

XXXXX o L/or 
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PARAMETER PROCESSING 

Certain user programs require parameters for their execution. DOS-Ill allows passing of parameters 
in the following environments: 

(1) from a main program to a main program 

(2) from a main program to a segment 

(3) from a segment to a main program 

(4) from a user to a suspended program 

Parameter transferral from program to program (1-3) is handled programmatically by specifying 
parameters in an EXEC calling sequence. Parameter transferral from a user directly to a program (4) 
is handled by passing parameters back to the suspended program through the GO directive. 

All the programs receiving parameters retrieve them in the same way. The parameters to be passed 
(if any) are located in the base page parameter buffer RONBF (see Appendix A). In the Assembly 
language environment, the B register contains the address of the parameter buffer. In the FORTRAN/ 
ALGOL environment, a library routine (RMPAR) is provided to transfer parameters to a user-defined 
buffer. (This call must be the first statement executed upon entry.) 



ASSEMBLY LANGUAGE EXAMPLE 
EXT EXEC 



JSB EXEC 
DEF *+2 
DEF RCODE 
LDA B,I 
SZA,RSS 
JMP NOPAR 



(Call EXEC to suspend program) 



(Get parameter from GO directive) 



RCODE DEC 7 
B EQU1 



FORTRAN EXAMPLE 

DIMENSION 1(5) 
CALL EXEC (7) 
CALL RMPAR (I) 



(Define user parameter buffer) 

(Suspend program) 

(Get parameters from :GO) 
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SECTION IV 
Input/Output 



In DOS-Ill, centralized control and logical referencing of I/O operations effect simple, device- 
independent programming. Each I/O device is interfaced to the computer through one or more I/O 
channels which are linked by hardware to corresponding main memory locations for interrupt 
processing. By means of several user-defined I/O tables, multiple-device drivers, and program 
EXEC calls, DOS-Ill relieves the programmer of most I/O problems. 



Note: Refer to Section XIV, "Privileged Mode, " for a discussion of privileged 
mode processing. 



USER PROGRAM I/O 

The user program requests I/O by means of an EXEC call (see Section III) which specifies the 
logical unit, control information, type of operation, buffer location and buffer length. 

Note: Within the DOS-HI environment, it is possible to transfer up to 16K 
words in a single operation. 

All references to I/O devices are made through logical unit numbers. This relieves the program- 
mer of the burden of knowing which physical device or which I/O channel is actually going to 
perform the I/O transfer. 



4-1 



DOS-Ill has the following standard function assignments for logical unit numbers: 



Restored 

after 

each 

:JOB. 



Logical Unit Number 

1 
2 
3 

4 
5 
6 
7 
8 
9 
10 



63 



10 



Function 

System console 

System mass storage 

User mass storage 

Standard punch device 

Standard input device 

Standard list device 

Unassigned 

Recommended for magnetic tape 

Can be assigned to any device 

by user 



The user determines the number of logical units when the system is generated. At the beginning of 
each JOB, logical units 1 through 9 are restored to the values established at system generation 
(see Section X), whereas 10 through 63 are restored only on a start-up from the disc. 



SYSTEM I/O PROCESSING 

System I/O processing is controlled by three I/O tables: 

1) Equipment Table (EQT) — which records all devices, I/O channels, driver entry 
points, DMA requirements, and disc location (if disc-resident). 

2) Logical Unit Table (LUT) — which assigns an equipment table number to each 
of its entries, thus allowing the programmer to reference changeable logical units 
instead of fixed physical units. 

3) Interrupt Table (INT) — which relates each I/O channel to its corresponding 
equipment table entry. 

For a detailed description of these tables see Appendix A. 
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When the system recognizes an EXEC call that performs I/O, the request is sent to the I/O supervisor 
EXEC module ($EX18). $EX18 determines if the driver for the requested device is main-memory 
resident; if not, the driver is loaded into main memory from the disc. Once the driver is in main- 
memory, the addresses of its EQT entries are placed in the base page communication area and control 
is transferred to the driver's initiation section. After the driver initiates the I/O operation, it returns 
to $EX18. If the I/O was requested "without wait", DOS-Ill immediately returns control to the 
user program; if the I/O was requested "with wait", DOS-Ill waits until the I/O transfer is complete 
before returning to the user program. 

Once a driver has been initiated, interrupts from the device are channeled through a central inter- 
rupt processing routine ($CIC). (All interrupt locations in main memory contain a JSB $CIC.) 
$CIC determines which device interrupted, resets the addresses of the EQT entries into the base 
page communication area (if necessary), and transfers control to the driver's continuation section. 
The driver either continues or completes the I/O operation, and control is then returned to the 
executing user program. 



INPUT/OUTPUT DRIVERS 

The I/O driver routines, either main-memory or disc-resident, handle the actual transfers of infor- 
mation between the computer and external devices. They are responsible for initiating and continu- 
ing operations on all devices of equivalent type. When a transfer is initiated, DOS-Ill places the 
EQT entry addressed into the base page communication area and executes a subroutine jump to the 
driver entry point. The driver configures itself for the particular channel (in this way the same 
driver can handle several devices of the same type on many channels), initiates the transfer, and re- 
turns to DOS-Ill. When an interrupt occurs on the channel, indicating continuation or completion 
of the transfer, DOS-Ill again transfers control to the driver. DOS-Ill requires only three drivers: the 
Moving-Head Disc Driver (DVR31), the System Console Driver (DVROO, DVR05, or DVR26), and 
the Paper Tape Reader Driver (DVR01). 

The following standard drivers are fully compatible with DOS-Ill: 



Driver Number 

DVROO 
DVR01 
DVR02 
DVR05 
DVR10 
DVR10 
DVR11 
DVR12 
DVR15 
DVR23 
DVR26 
DVR31 
DVR33 
DVR34 
DVR67 



Description 

System Console Driver (TTY) 
Paper Tape Reader Driver 
Paper Tape Punch Driver 
System Console Driver (TTY) 
Digital Plotter Complete Driver 
Digital Plotter Minimum Driver 
Card Reader Driver 
Line Printer Driver 
Optical Mark Reader Driver 
Magnetic Tape Unit Driver 
Terminal Printer Driver 
Disc Driver 

Writable Control Store Driver 
Card Reader Punch Driver 
Hardwired Serial Interface Driver 



Part Number 


DMA 


20985-60001 


No 


20987-60001 


No 


20989-60001 


No 


24157-60001 


No 


07210-16001 


No 


07210-16002 


No 


24272-60001 


Yes 


24307-16011 


No 


24307-16017 


No 


13024-60001 


Yes 


24307-16018 


No 


24156-60001 


Yes 


24278-60001 


Yes 


12989-16002 


No 


24341-16001 


No 
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The driver name consists of the letters "DVR" prefixed to the equipment type code. In addition, 
the programmer can write drivers for special devices, following the guidelines in Section XIII, 
"Planning I/O Drivers." The driver is only responsible for updating the status field in the EQT 
entry; DOS-Ill handles the availability field. 



SPECIAL DRIVER CONSIDERATIONS 

Since the various peripheral devices are unique, the drivers designed for use with these devices are 
also unique. This diversification creates the need for special considerations when planning input/ 
output operations. The DOS-HI Standard Drivers Reference Manual (24307-90073) deals at length 
with such subjects as creating plotter drawings (Section II), line printer formatting (Section IV), 
magnetic tape error recovery (Section VI), and using the writable control store driver (Section VIII). 
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SECTION V 
DOS-Ill Subsystems 



This section describes conventions for using the following DOS-Ill subsystems: 

• ALGOL Compiler 

• Assembler 

• FORTRAN and FORTRAN IV Compilers 

• Relocating Loader 

• Relocatable libraries, including the DEBUG subroutine 
and concludes with a discussion of program segmentation. 

SOURCE PROGRAM FILES 

Using the DOS-Ill STORE,S and EDIT directives, the operator creates and edits files of source pro- 
grams written in FORTRAN, ALGOL, or Assembly language. In load-and-go operations the 
FORTRAN Compiler, FORTRAN IV Compiler, ALGOL Compiler, and Assembler generate 
relocatable binary code onto temporary disc storage. The Relocating Loader can then relocate 
and merge the code with referenced subroutines of the Relocatable Library. Once loaded, a pro- 
gram is executed by the PROG or RUN directive. 



LOAD-AND-GO FACILITY 

DOS-Ill provides the facility for "load-and-go," which is defined as compilation or assembly, 
loading, and execution of a user program without using intervening object paper tapes. To 
accomplish this, the compiler or assembler generates relocatable object code from source statements 
and stores it on the disc in the Job Binary Area. Then separate directives initiate loading (PROG, 
LOADR) and execution ( RUN program). 

DOS-Ill can store the object code of several programs and associated segments and subroutines on 
the disc. The Relocating Loader retrieves them from the disc, and relocates them into executable 
absolute program units. 
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ALGOL COMPILER 

The ALGOL Compiler consists of a main program and a data segment which operate under the 
control of DOS-Ill. The compiler resides on the disc and is read into main memory when called 
for by a PROG directive. 

Source programs written in ALGOL are accepted either from an input device or from a user disc 
file and are translated by the ALGOL Compiler into relocatable object programs optionally 
punched on paper tape (and optionally stored in the Job Binary Area of the disc). The object pro- 
gram can be loaded using the DOS-Ill Relocating Loader and executed using the RUN or PROG 
directive. 



ALGOL I/O 

The HP ALGOL I/O statements should specify the proper logical unit numbers for the DOS-HI 
configuration. (See Section IV.) 



Compiler Operation 

The ALGOL Compiler is initiated with a PROG directive, and inputs the source program from an 
input device, or, if from a source file, from a file specified by a JFILE directive. The PROG direc- 
tive for the ALGOL Compiler should take the following form: 
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PROG, ALGOL 



:PROG,ALGOL[,P 1 ,P 2 J> 3 ,P 4 ,99] 

where P } =» logical unit number of input device (default is 5; set to 2 for source file 
input indicated by a JFILE directive) 

P 2 = logical unit number of list device (default is 6) 

P 3 = logical unit number of punch device (default is 4) 

P ' = lines/page on the source listing (default is 56) 

99 = the job binary parameter. If present, the object program is stored in the Job Binary 
Area for later loading. Any requested punch output still occurs. (The 99 may occur 
anywhere in the parameter list, but terminates the list.) 



All parameters are optional. If p-^ through p^ are not present, the default operations are assumed. 
If 99 is not present, the binary output is not placed in the Job Binary Area. 



Messages During Compilation 

When the end of a source tape is encountered, the following is output on the system console: 

I/O ERR ET EQT #n 

EQT #n is unavailable until the operator declares it up : 

:UP,n 
:GO 



Compilation continues after the :GO. More than one source tape can be compiled into one program 
by loading the next tape before giving the :GO. 
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At the end of the compilation, the following message is output to the system console: 
$END, ALGOL 



If the Job Binary Area (where binary code is stored because of a 99 parameter in the PROG 
directive) overflows, the following message is output and compilation continues: 



JBIN OVF 



The compilation will be completed, but there will be no further loading of binary code into the job 
binary area. 



The compiler terminates if 



• Logical unit 2 has been given for input and no : JFILE has been declared. The 
following message is output: 



NO SOURCE 



• The first statement of the source file specified by the PROG directive p^ parameter 
does not begin with the word HPAL. (Or the control statement contains an error.) 
The following message is output: 



HPAL?? 



• A colon occurs in the first position of a source statement line. The following message 
is output: 



IE nnnnn 



where nnnnn is the memory location of the input request. 
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Language Considerations 

The HP ALGOL control statement has this format: 
HPAL [,L,A,B,P], "name" [^ J [,P 2 ] 

where HPAL is mandatory 

L,A,B,P are symbols (any combination is allowed) representing: 

L produce source program listing 

A produce object code listing 

B produce object tape 

P a procedure only is to be compiled 

"name" is the program name (the quotes and a program name are mandatory) 

P is a decimal digit between and 9 specifying the name of the error routine to be 

called if an error occurs in ALOG, SQRT, .RTOR, SIN, COS, .RTOI, EXP, .ITOI, 
TAN. The name of the error routine is ERRrc, where n = P } , or n = if P is not 
specified. ERRO is supplied in the Relocatable Library; all other error routines 
must be supplied by the user. 

P 2 is a decimal digit specifying the type of the program: 3 for a main program, 5 for 

a segment, and 6 or 7 for a utility subroutine or procedure. If P 2 is not specified, 
the type is set to 3 for main programs and to 7 for procedures ( P option in the 
control statement). 



If no symbols are specified, the program will run but will not produce any output other 
than diagnostic messages and job binary (if requested). A program name in quotes (the NAM-record 
name which must be a legitimate identifier without blanks) must follow the symbols. 

Sense switch control is not used with DOS-Ill. 



EXAMPLE 



HPAL,L,B,"TEST",1,3 
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ASSEMBLER 

The Assembler, a segmented program that executes in the main-memory User Program Area, 
operates under control of DOS-Ill. The Assembler consists of a main program (ASMB) and six 
segments (ASMBD, ASMB1, ASMB2, ASMB3, ASMB4, ASMB5), and resides on the disc. The 
main program is read into main memory when called by a PROG directive. 

Source programs, accepted from either an input device or a user source file on the disc, are trans- 
lated into absolute or relocatable object programs; absolute code is punched in binary records, 
suitable for execution only outside of DOS-Ill. ASMB can store relocatable code in the Job Binary 
Area of the disc for on-line execution, as well as punch it on paper tape. 

A source program passes through the input device only once, unless there is insufficient disc storage 
space. In the latter case, DOS-Ill informs the user that two passes are required. 



Assembler I/O 

The Assembly Language I/O EXEC calls should specify the proper logical unit numbers for the 
DOS-Ill configuration. (See Section IV.) 

When preparing input for the batch device, the programmer must remember to never put a colon ( :) 
in column one of the source statement. DOS-Ill aborts the current program if a directive (signified 
by : in column one) occurs during data input. 

If the memory protect hardware option is present (and enabled), it protects the resident supervisor 
from alteration. It interrupts the execution of a user program under these conditions: 



• Any operation that would modify the protected area or jump into it. 

• Any I/O instruction, except those referencing the switch register or overflow register. 

• The halt instruction. 



Memory protect gives control to DOS-Ill when an interrupt occurs, and DOS-Ill checks whether it 
was an EXEC call. If not, the user program is aborted. 



Assembler Operation 

The DOS-Ill Assembler is initiated with a PROG directive. However, before entering the PROG 
directive, the operator must place the source program in the input device. If the source program is 
on the disc, the operator must first specify the file with a JFILE directive, and set parameter 
P2 = 2 in the PROG directive. The PROG directive for Assembler should take the following form: 



5-6 



PROCASMB 



:PROG,ASMB[,P 1 ,P 2 ,P 3 ,P 4 ,99] 

where P t = logical unit number of input device (default is 5 ; set to 2 for source file 
input indicated by a JFILE directive) 

P 2 = logical unit number of list device (default is 6) 

P 3 = logical unit number of punch device (default is 4) 

P 4 = lines/page on the source listing (default is 56) 

99 = the job binary parameter. If present, the object program is stored in the Job 

Binary Area for later loading. Any requested punch output still occurs. (The 99 
may occur anywhere in the parameter list, but terminates the list.) 



All parameters are optional. If p^ through p^ are not present, the default operations are assumed. 
If 99 is not present, the binary output is not placed in the Job Binary Area. 



Messages During Assembly 

When the end of a source tape is encountered, the following is output on the system console: 

I/O ERR ET EQT #n 

EQT #n is unavailable until the operator declares it up: 

:UP,n 
:GO 



Compilation continues after the :GO. More than one source tape can be compiled into one program 
by loading the next tape before giving the :GO. 
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The following message on the system console signifies the end of assembly: 

$END ASMB 
If another pass of the source program is required, this message is output at the end of pass one. 

$END ASMB PASS 
The operator must replace the program in the input device and enter: 

:GO 



If an error is found in the Assembler control statement, the following message is output on the 
system console: 



$END ASMB CS 



and the current assembly stops. 



If an end-of-file condition on source input occurs before an END statement is found, the console 
signals: 



$END ASMB XEND 



and the current assembly stops. 

If source input from logical unit 2 (disc) is requested, but no file has been declared (see : JFILE, 
Section II), the system console signals: 



$ENDASMBNPRG 

and the current assembly stops. 

If the Job Binary Area, where binary code is stored by a 99 parameter, overflows, assembly continues 
but the following message is output on the system console: 

JBINOVF 

However, no further binary code is stored in the Job Binary Area. 
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The next message is printed on a separate line just above each error diagnostic printed in the pro- 
gram listing during pass 1 . 

# nnn 



nnn is the "tape" number on which the error (reported on the next line of the listing) occurred. 
A program may consist of more than one tape. The tape counter starts with one and increments by 
one whenever an end-of-tape condition occurs (paper tape) or a blank card is encountered. When 
the counter increments, the numbering of source statements starts over at one. 

Each error diagnostic printed in the program listing during pass 2 of the assembly is associated with 
a different message (printed on a separate line just above each diagnostic): 



PG ppp 



ppp is the page number (in the listing) of the previous error diagnostic. PG 000 is associated with 
the first error found in the program. 



Language Considerations 

ASSEMBLER CONTROL STATEMENT. Although only relocatable code can be run under DOS-Ill, 
the DOS-Ill Assembler is able to assemble absolute code if it is specified. Absolute code is never 
stored in the Job Binary Area. To get absolute code, the control statement must include an "A" 
parameter. The "R" parameter, however, is not required for relocatable code. An "X" causes the 
assembler to generate non-Extended Arithmetic Unit code. 



EXAMPLES 



ASMB,L,B List and Punch Relocatable Binary. 

ASMB,R,L,B,X List and Punch Relocatable, non-EA U Binary. 

ASMB,T,L List and Print Symbol Table. 

ASMB,A,B,L List and Punch Absolute Binary. 
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NAM STATEMENT. The NAM statement allows up to eight optional parameters. Only the first 
two parameters are significant in DOS-Ill. 

NAM name [,type] [Jink mode] 

where name is the program name (it should not equal any file name). 

type is the program entry type code (octal): 

— System main memory resident (default) 

1 — Disc resident executive supervisor module 

2 — Reserved for system 

3 — User program, main 

4 — Disc resident device driver 

5 — User program segment 

6 — Library routine 

7 — Subroutine 

10 — Relocatable binary 

11 — ASCII source statements 

12 — Binary data 

13 - ASCII data 

14 — Absolute binary 

link mode is the mode of linkage to be performed: 

— current page linking 
non-zero — base page linking (default) 

If type is 0, 1, 2, or greater than 7, the assembler and DSGEN will accept it, but the Relocating 
Loader will not. 

The link mode parameter specifies the mode of linking that will occur at system generation time. If 
zero, current page linking occurs. If non-zero, base page linking occurs. If omitted, the default con- 
dition (non-zero) is assumed and base page linking occurs. 

In addition to the name defined by NAM, each program, with the exception of the main program, 
has one or more entry points defined by an ENT statement. For the main program (type = 3), the 
transfer address of the END statement is sufficient. The program name is used for programmer-to- 
DOS-III communication, while the entry point is used for program-to-program communication. 



Note: DOS-HI Assembly language does not contain the ORB statement because 
information cannot be directly loaded into the protected base page area 
by user programs. However, programs can read information from base 
page using absolute address operands up to 1777%. 
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FORTRAN COMPILERS 

The FORTRAN Compilers operate under control of the DOS-Ill Supervisor. The compilers reside 
on the disc and are read into main memory only when needed. 

FORTRAN and FORTRAN IV are problem-oriented programming languages. Source programs, 
accepted from either an input device or a user disc file, are translated into relocatable object 
programs, optionally punched on paper tape, and optionally stored in the Job Binary Area of the 
disc. The object program can be loaded using the DOS-Ill Relocating Loader and executed using 
the RUN or PROG directive. 



FORTRAN I/O 

FORTRAN I/O statements should specify the proper logical unit numbers for the DOS-Ill 
configuration. (See Section IV.) 

When preparing input data for the batch device, the user should never put a colon (:) in column one 
of the record because the colon in the first position signifies a directive. DOS-Ill aborts the job if a 
directive occurs during data input. 



Compiler Operation 

The FORTRAN compilers are initiated with a PROG directive, and input the source program from 
an input device, or, if from a source file, from a file specified by a JFILE directive. The PROG 
directive for FORTRAN compilers should take the following form: 
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PR0G,FTN[4] 



:PROG,FTN[,P 1 ,P 2 ,P 3 ,P 4 ,99] 

:PROG,FTN4 [,P t ,P 2 ,P 3 ,P 4 ,99] 

P = logical unit number of input device (default is 5 ; set to 2 for source file input indicated 
by a JFILE directive) 

P 2 = logical unit number of list device (default is 6) 

P 3 = logical unit number of punch device (default is 4) 

P = lines/page on the source listing (default is 56) 

99 = the job binary parameter. If present, the object program is stored in the Job Binary Area 
for later loading. Any requested punch output still occurs. (The 99 may occur anywhere 
in the parameter list, but terminates the list.) 

All parameters are optional. If p-^ through p^ are not present, the default operations are assumed. 
If 99 is not present, the binary output is not placed in the Job Binary Area. 



Messages During Compilation 

When the end of a source tape is encountered, the following is output on the system console: 

I/O ERR ET EQT #n 
EQT #n is unavailable until the operator declares it up: 



:UP,n 
:GO 



Compilation continues after the :GO. More than one source tape can be compiled into one program 
by loading the next tape before giving the :GO. 

At the end of compilation, the following message is output on the system console: 
$END, FTN[4] 
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If the Job Binary Area (where binary code is stored because of a 99 parameter in the PROG direc- 
tive) overflows, the following message is output and compilation continues: 



JBIN OVF 

There is no further loading into the Job Binary Area. 
The compiler terminates if 

• logical unit 2 has been given for input and no JFILE has been declared. 
($END,FTN[4] is not output.) 

• There are not enough work tracks for the compiler. The following message is output: 

# TRACKS UNAVAILABLE 



• A colon occurs in the first column of a source program entered through the batch 
device. (Blank cards in the source program are ignored.) The following message is 
output. 



IE nnnnn 



where nnnnn is the memory location of the input request. 



Language Considerations 

FORTRAN CONTROL STATEMENT. Besides the standard options described in the FORTRAN 
manual, two compiler options, T and n, are available. A "T" lists the symbol table for each program 
in the compilation. If a "u" follows the address of a variable, that variable is undefined (the program 
does not assign a value to it). The A option includes this T option. If n appears, n is a decimal digit 
(1 through 9) which specifies an error routine. The user must then supply an error routine, ERRn. 
If this option does not appear, the standard library error routine, ERRO, is used. The error routine 
is called when an error occurs in ALOG, SQRT, .RTOR, SIN, COS, .TROI, EXP, .ITOI, or TAN. 
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Extended and Auxiliary Statements 

In addition to the standard FORTRAN statement, the FORTRAN compiler running under DOS-Ill 
supports the following extensions and additions: 

1. extended PROGRAM statement 

2. additional DATA statement 

3. additional EXTERNAL statement 

Execution of the following two FORTRAN statements results in special processing in the DOS-Ill 
environment: 

1. PAUSE 

2. STOP 
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PROGRAM STATEMENT 



The program statement includes an optional type parameter. 



PROGRAM name [,type] [Jink mode] 



name 



is the five-character name of the program (and its main entry point. 
When the program is executed using a RUN or PROG directive, this 
name is used. 



type 



is a decimal digit specifying the program type. Only types 3 (main), 
5 (segment), and 6 or 7 (library) are significant in DOS-Ill. The type 
is set to 3 if not given. 



link mode is the mode of linkage to be performed: indicates current page 

linking and any non-zero digit indicates base page linking (default). 
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DATA STATEMENT 



The DATA statement sets initial values for variables and array elements. The format of the DATA 
statement is 



DATA kjdjjijdj, . . . MJdJ 



where k is a list of variables and array elements separated by commas, d is a list of (optionally 
signed) constants, separated by commas and optionally preceded by j* (j is an integer 
constant). 

The elements of d j are serially assigned to the elements of k^ ■ The form j* means that the constant 
is assigned j times. The fej and d-^ must correspond one-to-one. 

Elements of kj must not be from COMMON. 

Arrays must be defined (i.e., DIMENSION) before the DATA statements in which they appear. 
DATA statements may occur anywhere in a program following the specification statements. 



EXAMPLE 

DIMENSION A(3), 1(2) 
DATAA(1),A(2),A(3)/1.0,2.0,3.0/,I(1),I(2)/2*1/ 
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EXTERNAL STATEMENT 



With the EXTERNAL statement, subroutines and functions can be passed as parameters in a sub- 
routine or function call. For example, the routine XYZ can be passed to a subroutine if XYZ is 
previously declared EXTERNAL. Each program may declare up to five EXTERNAL routines. 

The format of the EXTERNAL statement is 



EXTERNAL v lt v 2 ,. . . ,v B 
where v is the entry point of a function, subroutine, or library program. 
EXAMPLE 



EXTERNAL XYZ,FL1 

Z = Q-RMX(XYZ,FL1,3.56,4.75) 



END 



FUNCTION RMX(X, Y,A,B) 
RMX = X(A)*Y(B) 
END 



ERROR E-0018 means too many externals. 



Note: If a library routine, such as SIN, is used as an EXTERNAL, the compiler 
changes the first letter of the entry point to "%". Special versions of the 
library routines already exist with the first character changed to "%". 
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PAUSE AND STOP 

PAUSE causes the following message to be output to the system console: 

PA USE xxxx 

where xxxx is an optional octal number. 

To restart the program, the operator uses a GO directive. 

STOP causes the program to terminate after the following message: 

STOP program name xxxx 

where xxxx is an octal number. 
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ERRO LIBRARY ROUTINE 



ERRO, the error print routine referred to under the FORTRAN or ALGOL control statement, out- 
puts the following message to the system console whenever an error occurs in a library routine : 



name: nn xx 



where name is the name of the user's program, 
nn is the routine identifier, and 
xx is the error type. 



The compiler generates calls to ERRO automatically. If the FORTRAN (or ALGOL) control 
statement includes an n option, the call will be to ERRn, a routine which the user must supply. 
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DOS-Ill RELOCATING LOADER 

The DOS-Ill Relocating Loader accepts relocatable object programs which have been translated by 
the Assembler, ALGOL Compiler, or FORTRAN Compilers. It generates an executable main- 
memory image of each such program. The relocatable programs may enter the loader as 



• Job Binary Area programs translated during the current job 

• User files 

• Punched tapes, magnetic tapes 

• Subroutines from the disc-resident Relocatable Library 



Each main program is relocated to the start of the User Area and linked to its external references, 
such as library routines. Segments will overlay the area following the main program and its sub- 
routines. Programs may run under control of the DEBUG library routine. The main program, plus 
its subroutines and its longest segment, can be as large as the User Area. With a RUN or PROG 
directive, the program is called by name from the disc and executed. With the STORE,P directive, 
the program may be stored as a permanent user file to be run during a later job. If the Loader is 
to be re-executed during a single job, the Job Binary Area must be cleared (using the CLEAR 
directive) to prevent duplicate program names. 
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PROG, LO ADR 



The DOS-Ill Relocating Loader is initiated by a PROG directive from the batch or keyboard device. 

Format 

:PROG,LOADR [,P 1 ,P 2 ,P 3 ,P 4 ,P 5 ] 

Pj = for loading from JBIN and relocatable library (default) 

= 2 for loading from JBIN, user files, and relocatable library 

= n for loading from JBIN, user files, relocatable library, and paper tape or 
magnetic tape (logical unit n) 

P 2 = list device logical unit number (default is 6) 

P 3 = for no DEBUG, # for DEBUG (default is 0) 

P 4 = for base page linking, ¥= for current page linking (default is 0) 

P = for system default program bounds (e.g., UBFWA-UBLWA and 

UMFWA-UMLWA); = 1 for user-specified program bounds (default is 0) 



Comments 

INPUT PARAMETER [P-J . Note the hierachy here. If n is specified, the JBIN area is still scanned 
first, then user files are requested and, finally, the peripheral relocatable input is accepted. 

If P^ f zero, the Loader first expects a list of relocatable file names. In keyboard mode, the 
Loader requests: 

ENTER FILE NAME(S) OR IE 

then waits for input. After each list of files is entered, the message repeats until a /E is entered. 

In batch mode the list of files is entered as 

file-name 1, file-name 2, . . . ,/E 

following the PROG directive (or following the bounds parameters if Pg = 1). If there are no 
user files, a /E record must be entered. 
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The file list is a series of records containing file names separated by commas, ending with a /E. 
All programs in each file are loaded unless a particular subset of the file is specified: 

file-name (prog 1, prog 2 . . .) 

Only the programs specified within the parentheses are loaded from the file-name. The file list is 
simply a "/E" if no files are to be loaded. (The search for these files is made only on the current 
user disc; the Loader is unaffected by :SS.) 



DEBUG PARAMETER [P3] . Selecting the DEBUG option causes DEBUG to be appended to each 
main program and segment. The Loader sets the primary entry point of each to DEBUG, rather 
than the user routine. When the program is run, DEBUG takes control of the program's execution 
and seeks instructions from the system console. 



CURRENT PAGE LINKING PARAMETER [P 4 ] . If requested to do so (P 4 f zero), the Loader 
attempts to place necessary program links on the current page of memory as opposed to the base 
page, to provide more area on the base page for large programs. 

Note: While using the Loader with the current page linking option, remember that: 

a. Current page linking cannot be used on programs which use main 
memory following the program area for writing data (at execution 
time). For instance, the Assembler builds its symbol table imme- 
diately following the last word of the largest segment. 

b. Programs should be broken into subroutines of less than 2K 
because links are generated only at the beginning and end of 
the program. Links cannot be inserted into the middle of a 
program since the boundary between program and links may 
fall in the middle of a skip or jump sequence. If the program 
spans more than two pages, the middle page(s) will have no 
area available for current links and will use base page links; thus, 
the potential for greater efficiency will be lost. 



PROGRAM BOUNDS SPECIFICATION PARAMETER [P 5 ] . The user has the option of specifying 
the base page bounds and the main memory bounds for the relocatable modules being loaded. If 
parameter Pg in the PROG,LOADR directive is zero, the program bounds are determined by the 
system pointers: 

UBFWA lower base page bound 

UBLWA upper base page bound 

UMFWA lower main memory bound 

UMLWA upper main memory bound 

If P5 is equal to one, the user can specify his own memory bounds. In batch mode, the Loader 
reads the bounds from the input device immediately following the :PROG, LOADR directive. The 
bounds are in the form of two records: the first record is interpreted as the lower and upper base 
page bounds, specified by two octal constants separated by a comma. If an error occurs in the first 
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record, the Loader outputs an L18 error message. The second record is interpreted as the lower 
and upper main memory bounds, specified by two octal constants separated by a comma. If an 
error occurs in the second record, the Loader outputs an L19 error message. If any of the bounds 
are omitted, the appropriate system default value is used. In keyboard mode, the two records are 
entered in response to the messages 

BP BND [L,U] ? 

PROG BND [L,U] ? 

If an error occurs while entering the bounds in keyboard mode, the user can re-enter the bounds 
(after an L18 or L19 error message). If an L18 or L19 error message occurs in batch mode, the 
Loader aborts the job. 



I/O Drivers 

The Loader will accept Type 4 programs (Disc Resident Device Drivers) and store them as such in 
the user directory. Type 4 programs cannot be combined with any other program type during any 
given load operation. 



Loader Operation 

The DOS-HI Relocating Loader is a two-pass Loader. The first pass consists of setting the bounds, 
inputting and scanning relocatable programs to build the necessary tables (program name table 
and a table of entry points and externals), and matching entry points with externals. The second 
pass involves the relocation of the programs into an absolute core image format on the disc. 



INPUTTING AND SCANNING THE PROGRAMS. Programs are scanned (and input, if necessary) 
according to P-^ in the PROG,LOADR directive. (Only non-disc relocatable programs must be input; 
there are stored temporarily on the Work Area of the disc for processing during the second pass.) 
Since main programs are matched with segments during the scan, each main program must be loaded 
before any of its segments. 

If paper tape input is requested, the following messages are output to the system console: 

LOAD TAPE 
LOADR SUSP 
@ 

The loader suspends. The operator places a tape in the input device and types 
:GO 
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When an end-of-tape condition occurs, three messages are output to the system console: 

I/O ERR ET EQT# nn (paper tape only— not magnetic tape) 

LOAD TAPE 
LOADR SUSP 
@ 

The operator places the next tape in the input device, enters :UP,nn and :GO to read the next tape. 
Enter :UP,rcrc and :GO,l to indicate that all tapes have been read in. 

If a checksum error occurs when loading relocatable programs from paper tape, the Loader prints 
an L01 error message and returns to the paper tape load point with the messages 

LOAD TAPE 
LOADR SUSP 

@ 

The operator can attempt to reload the program by placing the tape in the reader at the beginning 
of the program and typing :GO. 



Matching Entries with Externals 

After matching all possible entry points and external references in the user programs, the loader 
scans the Relocatable Library (disc-resident) looking for entry points to match the undefined 
external references. If undefined external references still exist, 

UNDEFINED EXTS 

is output and the external references are listed, one per line. 

To load additional programs from a peripheral device, the operator types 
:GO,0[,n] 

where n is the logical unit number of the input device, if different from P-^ of the PROG,LOADR 
directive. 

To continue without fulfilling external references, the operator types 
:GO,l 

To specify a file name from the keyboard, enter 
:GO,2 

and the appropriate prompt is output: 
ENTER FILE NAME(S) OR IE 
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RELOCATING PROGRAMS. The main and segment names (from the PROGRAM, HPAL, or NAM 
records) become user file names once the programs are loaded. To ensure unique file names, the 
Loader compares all program and segment names against the names of existing user files (current 
user disc only). If duplicate names occur, an error message is printed and loading stops. 

The Loader converts each main program into an absolute main memory image, stores it on the disc, 
places the name in the user directory where it remains during the current job, and lists (on the 
logical unit specified by the P2 parameter) the program address map and entry points. After each 
main program, any associated segments are loaded in the same way. When the Loader is completely 
finished, the following message is output: 

LOADR COMPLETE 

During the current job, the absolute main memory images appear in the user file area (see LIST 
directive, Section II) and can be executed by name (see RUN and PROG directives). At the end of 
the job, however, they disappear from the file area, unless they are made permanent files by means 
of the STORE, P directive. 

If no programs are entered, the Loader outputs the following messages and terminates: 

NO PROGRAMS LOADED 
LOADR COMPLETE 

Loader error messages are given in Section XV. 
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EXAMPLE 



In the following example, DOS-Ill is in keyboard mode. 



: CLEAR 

§ 

: PROG, LOADR, 5 

ENTER FILE NAMECS) OR /E 

ALGLM,/E 

LOAD TAPE 

LOADR SUSP 

@:GO 

I/O ERR ET EQT# 02 

LOAD TAPE 

LOADR SUSP 

8 : UP, 2 

@:GO, 1 



Eliminate any programs from the job binary area 

Paper tape input is specified 

One disc file is specified 

Place paper tape in input device 

Return to Loader 
End of paper tape 

Declare input device ready 
Specify no more paper tapes 
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The following is then output on the standard list device (logical unit 6): 
RELOCATING LOADER 
NAME PROG BOUNDS BP BOUNDS 



ALGOL 




♦HPAL 


26601 


*%HPST 


27005 


.EAU. 


30370 


*.MPY 


30370 


*.DIV 


30375 


*.DLD 


30402 


*.DST 


30407 


%¥RIT 


30440 


*%WRIT 


30626 


*%WRIF 


30522 


*%t,;BUF 


30725 


SREAD 


31 141 


*%READ 


31 141 


*%JFIL 


31612 


*%RDSC 


31563 


DUMRX 


31677 


*$LIBR 


31677 


*$LIBX 


31724 


.OPSY 


31757 


*.OPSY 


31757 


(BOUNDS) 


16000 


ALGL1 




*ALGL1 


32461 


♦ XLNAL 


32020 


*%A3AL 


32017 


C BOUNDS) 


32017 


LOADR COMP 


LETE 


§:ST,P 





01402 



Main program 

Main's entry points 
Subroutine 

Subroutine's entry points 



01407 



0141 1 



01412 



01412 



007 1 6 1415 Main programs bounds 



Segment 

Segment's entry points 



32463 



01415 01416 



Segment's bounds 



Console message to indicate normal Loader completion 
Make newly created programs permanent disc files 
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THE RELOCATABLE LIBRARIES 

There are two System libraries, or collections of relocatable subroutines that can be used by DOS- 
Ill: the RTE/DOS Relocatable Library (EAU or Non-EAU versions) and the RTE/DOS FORTRAN 
IV Library. These libraries contain mathematical routines such as SIN and COS, and utility routines 
such as BINRY. A program signifies its need for a subroutine by means of an "external reference." 
External references are generated by EXT statements in Assembly language, by CALL statements and 
external function references in FORTRAN, and by CODE procedures in ALGOL. 

When the system is generated, several combinations of libraries are possible. Every system should 
contain an RTE/DOS Relocatable Library: either an EAU version or a non-EAU version, depending 
on the computer hardware. This library does not contain a formatter, but the FORTRAN IV Library 
contains a formatter that handles extended precision numbers. If extended precision arithmetic is 
not needed, a separate RTE/DOS Basic FORTRAN Formatter is available to take the place of the 
FORTRAN IV Library. 

All of these libraries and the subroutines they contain are documented in the manual Relocatable 
Subroutines (02116-91780). 
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DEBUG LIBRARY SUBROUTINE 

RTE/DOS DEBUG, a subroutine of the Relocatable Library, allows the programmer to check for 
logical errors during program execution. If the third parameter specified in the PROG, LOADR 
directive is non-zero, the DEBUG subroutine is appended to the user program being loaded. The 
primary entry point (where execution begins) is set to DEBUG. When the program is executed 
with a RUN directive, the DEBUG subroutine has control and displays the message: 

BEGIN 'DEBUG' OPERATION 

The programmer may enter any DEBUG operation directive. Illegal entries are ignored but result 
in the message: 

ENTRY ERROR 
Re-enter the DEBUG operation directive correctly. 



DEBUG OPERATIONS 

B,n Instruction breakpoint at octal address n (Note: if n = JSB EXEC, a 

memory protect violation occurs) 

D,A,n^,rt<27 ASCII dump of octal main memory address n^ or from n^ through w^ 

D,B,n^/,n27 Binary dump of octal main memory address nj or from rij through n^ 

M,n Sets absolute base of relocatable program unit at octal address n 

R[,n] Execute user program starting at octal address n or execute starting at 

next location in user program (used after a breakpoint or to initiate the 
program at the transfer point in the user program) 

S,n,d Set octal value d in octal address n 

S,n,d^,d2, . . • ,d n Set octal values d^ through d n in successive memory locations beginning 

at octal address n 

W,A,d Set A-register to octal value d 

W,B,d Set B-register to octal value d 

W,E,d Set E-register to octal value d (O=off; non-zero = on) 

W,0,d Set Overflow to octal value d (0 = off; non-zero = on) 

X,n Clear breakpoint at octal address n 

A Abort DEBUG operation. 
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SPECIAL CONSIDERATIONS 

Because of the extended instruction group coding available to the programmer using an HP 21MX 
Computer Series system, the current RTE/DOS DEBUG subroutine should not be used within these 
systems. 

For systems based on an HP 21MX series processor, a modified version of the subroutine called HP 
21MX RTE/DOS DEBUG is available and should be used in place of the current subroutine. HP 
21MX RTE/DOS DEBUG can be used only on HP 21MX Computer Series systems, it cannot be 
executed successfully on systems based on an HP 2100A or HP 2100S processor. 

During the Program Input Phase of RTE or DOS-HI system generation, load the HP 21MX RTE/ 
DOS DEBUG subroutine from paper tape (relocatable binary code) immediately after loading the 
RTE/DOS Relocatable Library. An error message indicating the existence of a duplicate program 
name will be displayed but the system generator will proceed to replace the current RTE/DOS 
DEBUG subroutine with the HP 21MX version. 

Externally, with a few differences, the HP 21MX RTE/DOS DEBUG subroutine appears the same 
as the current version in the RTE/DOS Relocatable Library. The differences are as follows: 

1. HP 21MX RTE/DOS DEBUG allows the programmer to set breakpoints on instructions which 
are extensions to the base set microcode. Breakpoints set on standard HP 21MX instructions— 
specifically, base set, base set extension (extended instruction group), single precision floating 
point arithmetic, or extended arithmetic unit (EAU) instructions — are processed normally; 
that is, the break occurs before execution of the instruction and is not cleared if the program- 
mer resumes execution of his program. Breakpoints set on instructions which are extensions 
to the standard instruction set — FFP, user written instructions, and so forth — result in the 
breakpoint being cleared after execution of the break. 



Note: In the current RTE/DOS DEBUG subroutine, setting a breakpoint on 
a non-EAU multiple-word instruction results in the incorrect execution 
of the instruction at the breakpoint. 



2. HP 21MX RTE/DOS DEBUG displays the contents of the X-register and Y-register as part 
of the standard breakpoint message. 

3. HP 21MX RTE/DOS DEBUG provides two additional operation directives which allow the 
programmer to set the X-register or Y-register to specific values. These directives are: 

W,X,d Set X-register to octal value d 

W,Y,d Set Y-register to octal value d 
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SEGMENTED PROGRAMS 

User programs may be structured into a main program and several segments, as shown in Figure 5-1. 
The main program begins at the start of the user program area. The area for the segments starts 
immediately following the last location of the main program. The segments reside on the disc and 
are read into main memory by EXEC calls, when needed. Only one segment may be in main memory 
at a time. When a segment is read into main memory, it overlays the segment previously in main 
memory. 

The main program must be type 3, and the segments must be type 5. When using DSGEN to con- 
figure the system or loading programs with the Loader, the main program must be entered prior 
to its segments. One external reference from each segment to the main routine is required for 
DSGEN or the Loader to link the segments and main programs. Also, each segmented program 
should use unique external reference symbols. Otherwise, DSGEN or the Loader may link segments 
and main programs incorrectly. 



Main Program 



Segment 1 



Segment 2 



Segment 3 



) DISC MEMORY 









Main Program 


high memory 


Segment Overlay 
Area 





, MAIN MEMORY 
(User program area) 



Figure 5-1. Segmented Programs 
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Figure 5-2 shows how an executing program may call in any of its segments from the disc using the 
SEGMENT LOAD EXEC call (1-2). DOS-Ill locates the segment on the disc (3-4), loads it into 
main memory (5) and begins executing it. The segment may call in another of the main program's 
segments using a similar EXEC call (6). 



DISC MEMORY 



MAIN MEMORY 



Main 
Program 



Segment 1 (^ 



Segment 2 



Segment 3 



(CALL for 
Segment 2) 



low memory 
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DOS-Ill 
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EXT EXEC 
ENTM 



(7) JSB EXEC 



NAM SEG1 
EXT EXEC, M 



®: 

© JSB EXEC 



Main 
Program 



Segment 
1 Overlay 
Area 
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User 

Program 
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Figure 5-2. Main Calling Segment 
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Figure 5-3 shows how DOS-Ill processes the call from the segment (7) by locating the segment on 
the disc (8-9), loading it into main memory (10), and beginning execution of it. 
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Figure 5-3. Segment Calling Segment 
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When a main program and segment are currently residing in main memory, they operate as a single 
program. Jumps from a segment to a main program (or vice versa) can be programmed by declaring 
an external symbol and referencing it via a JMP or JSB instruction. (See Figure 5-4.) A matching 
entry symbol must be defined as the destination in the other program. DSGEN or the Loader 
associates the main programs and segments, replacing the symbolic linkage with actual absolute a 
addresses (i.e., a jump into a segment is executed as a jump to a specific address). The programmer 
should be sure that the correct segment is in main memory before any JMP instructions are 
executed. 
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Figure 5-4. Main-to-Segment Jumps 
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FORTRAN Segments 

Segmented user programs may be written in FORTRAN, but certain conventions are required. A 
segment must be defined as type 5 in the PROGRAM statement. The segment must be initiated by 
using the SEGMENT LOAD EXEC call (RC DE = 8) from the main or another segment. A dummy 
CALL to the main must appear in each segment to ensure that proper linkage will be established be- 
tween the main and its segments. 

Once a segment is loaded, control is passed to it and execution begins at its primary entry point (or 
at the address specified in base page location 135g). The segment, in turn, may call another segment 
using another SEGMENT LOAD EXEC call. Communication between the main program and seg- 
ments may be through COMMON or via parameters passed in the SEGMENT LOAD or SEGMENT 
RETURN EXEC calls. 

Any segment may return to the main program at the statement immediately following the initial 
SEGMENT LOAD EXEC call (RCODE = 8) by executing a SEGMENT RETURN EXEC call 
(RCODE = 29). (See Section III for a description of these EXEC calls.) However, segments may 
not return directly to other segments. 



ALGOL Segments 

ALGOL programs can be segmented if certain conventions are followed. A segment must be defined 
as type 5 in the HPAL control statement. The segment must be initiated by using the SEGMENT 
LOAD EXEC call (RCODE = 8) from the main or another segment. In order to establish the proper 
linkage between a main program and its segments, each segment must declare the main a CODE 
procedure. For example, if MAIN is the main program, each segment must declare the following: 

PROCEDURE MAIN ;C ODE; 

Once a segment is loaded, control is passed to it and execution begins at its primary entry point (or 
at the address specified in base page location 135g). The segment, in turn, may call another segment 
using another SEGMENT LOAD EXEC call. Communication between the main program and its seg- 
ments may be through parameters passed in the EXEC call. 

Any segment may return to the main program at the statement immediately following the initial 
SEGMENT LOAD EXEC call by executing a SEGMENT RETURN EXEC call (RCODE = 29). (See 
Section III for a description of these EXEC calls.) However, segments may not return directly to 
other segments. 
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SECTION VI 
Typical DOS-Ill Job Decks 



1. ASSEMBLE A PROGRAM AND STORE IN FILE 



:JOB,ASMBS 
:PROG,ASMB, 5, 6,4, 56, 99 
ASMB,B,L 

NAM TEST,3 



END ENTER 
:STORE,R,AFILE 
:JOB,NEXTJ 



Source Program 



2. LOAD AND EXECUTE A RELOCATABLE FILE 

:JOB,LOADE 
:PROG,LOADR,2 

AFILEJE 

:STORE,P,TEST 

:RUN,TEST 

10 

23 

Data 



51 
:JOB,NEXTJ 
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3. STORE, EDIT, COMPILE, LOAD AND RUN A PROGRAM 

: JOB, EVERY 

:STORE,S,SOURC,5 

FTN,B,L 

PROGRAM ZOOM 

DIM 1(10) 

Source Program 



END$ 



LIST,S,6,SOURC 
EDIT,SOURC,5 
11,2 



IE 

JFILE,SOURC 

PR OG,FTN, 2, 6, 4, 56, 99 

PROG,LOADR 

RUN, ZOOM 
123.62 



00001 

:RUN,ZOOM 

321.5 



0.56 
:JOB,NEXTJ 



Edit List 



Data for first run- 



Data for second run 



4. LIST ONLY ERROR STATEMENTS ON SYSTEM CONSOLE IN A COMPILE 

:PR,FTN4„1 
FTN4 

PROGRAM EX1 



END 
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5. COPY A SYSTEM FROM SUBCHANNEL 1 TO SUBCHANNEL 



:JO 

JOB 

@ 

:UD„0 

LBL=SYSTEM 



TODAY 



TIME=0831 MIN. 43.3 SECS. 

Interrogates the system as to what label 
is on subchannel 0. 



:UD,SYSTEM,0 

@ 

:UD 

SUBCHAN=0 

LBL=SYSTEM 

@ 

:IN,* 

DOS LABEL SYSTEM 

OK TO PURGE? 

YES 

@ 

:UD 

SUBCHAN=0 

UNLBL 

@ 



Change current user disc to subchannel 



Verify 



Purge system and user files on subchannel 



Verify purge 



:UD,*,1 

@ 

:UD 

SUBCHAN=1 

UNLBL 

@ 

:DD,X 

@ 

:UD,*,0 

@ 

:UD 

SUBCHAN=0 

LBL=SYSTEM 

@ 

:EJ 

END JOB 

@ 



Change current user disc to subchannel 1 
Verify 



Copy system to subchannel 



RUN=0008 MIN. 01.7 SEC. EXEC=0000 MIN. 00.0 SEC. 
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PART 2 

DOS-Ill Extended File 
Management Package (EFMP) 



SECTION VII 
EFMP Organization 



The DOS-Ill Extended File Management Package (EFMP) extends the file handling capabilities of 
DOS-Ill by allowing the user to create and use files with different record lengths, security codes, 
and other conveniences. EFMP consists of a series of additional EXEC modules and a utility pro- 
gram; it maintains a file structure that operates within, and in addition to, the standard DOS-Ill 
file structure. 



ENVIRONMENT 

EFMP functions in the DOS-Ill environment. It is implemented through a set of EXEC modules 
which are incorporated into DOS-Ill at system generation time: the EXEC modules are invoked 
using the standard EXEC call mechanism. 



FUNCTIONS AND STRUCTURE 

The EFMP modules themselves allow any program executing in the user area to Initialize EFMP 
areas, Create/Destroy, Open/Close, Read/Write, Reset, Repack, Copy, Change Name, and Post files 
on the moving-head disc. Also, EFMP makes available detailed status information on all files and 
packs known to it. EFMP may be accessed conversationally from the keyboard by using UTIL, a 
utility program that executes in the User Area. 



DOS-Ill Files vs. EFMP Files 

DOS-Ill maintains files that are referenced by five-character names and relative sector numbers. The 
user can access these files in either a keyboard mode (via directives) or in a programming mode 
(via EXEC calls). In keyboard mode, the user creates a file with the STORE directive and operates 
on that file with directives such as :EDIT and :DUMP. In programming mode, the DOS-Ill files are 
accessed by EXEC calls such as FILE RE AD/ WRITE and FILE NAME SEARCH. 

In addition to the file structure, DOS-Ill maintains a subchannel (or user disc) identification scheme. 
User discs are first formatted either during system generation or by a special function of the system 
generator. These functions format the hardware tracks and set up information such as the Label 
Presence Code and System Proprietary Code. After a disc pack is formatted, the INITIALIZE directive 
is used to set up labels (six-character codes), change labels, and purge old discs. 
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EFMP operates within this file structure of DOS-Ill to set up and maintain additional— but distinctly 
different— files. Areas of discs within DOS-Ill (hereafter referred to as EFMP areas) are turned over 
to EFMP exclusively. The user must identify them with a pack number of the form PNxxx, where 
xxx is a decimal integer. The procedure for doing this is described under "Set Up." 

Within an EFMP area, EFMP creates files of its own that are not known to DOS-HI. They are identi- 
fied by a fixed-length name, contain a grouping of specified length records, and have a security code. 
Since only the DOS-Ill files can be created and accessed by directives, all EFMP files must be used 
through the EFMP EXEC calls or the UTIL program. EFMP files are limited in size only by the re- 
quirement that they fit within one subchannel or pack. 

Note: All references to files within this Part will mean EFMP files, not 
DOS-HI files, unless specifically stated otherwise. 



Duplicate Pack Numbers 

EFMP pack numbers are always unique on any given platter, but not necessarily unique across 
platters. To minimize the possibility of accessing a duplicate pack number, the user should (if 
possible): 

1. Create unique pack numbers. 

2. Have platters containing EFMP areas mounted on the subchannel designated as the current 
user subchannel. 



EFMP Buffers and Tables 

To provide maximum flexibility in main memory size and speed of file accessing, EFMP allows the 
user to define (at execution time) the size and location of the tables and buffers required in main 
memory by EFMP. Two areas are defined by the user and provided in his program space: 

1. Opened File Table 

2. Temporary Record Buffers 

The Opened File Table contains all information necessary for EFMP to identify and access files 
belonging to the user. The minimum size of the Opened File Table is one sector (128 words) and 
allows up to seven files to be opened concurrently. 

EFMP uses the Temporary Record Buffers as an intermediate storage area between the disc and 
the user's record buffer. The user defines the number of Temporary Record Buffers and the size of 
each. There must be at least one buffer and it must be at least two sectors (256 words) long. Par- 
ticular files and buffers can be linked to increase the access speed of files. The effect of varying the 
number and size of these buffers cannot be predicted exactly and must be determined empirically 
by trial and error. 

CA UTION: SINCE THESE TABLES AND BUFFERS EXIST IN THE USER 
AREA AND ARE NOT PROTECTED, EXTREME CAUTION 
MUST BE TAKEN NOT TO MODIFY THEM IN ANY WA Y. 
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Logical Read vs. Physical Read 

A logical read occurs each time the user requests a record from a file. At that time EFMP checks 
the appropriate Temporary Record Buffer to determine if the requested record is already in main 
memory. If in main memory, the record is transferred to the user's record buffer without actually 
physically reading the disc. If the record is not present in main memory, the necessary disc transfers 
are performed (physical reads— and writes, if necessary) to bring the record into main memory. If 
the Temporary Record Buffer is larger than the record size, several records are brought into main 
memory at once. 



Logical Write vs. Physical Write 

A logical write occurs each time a user requests that a record be written to a file. At that time, 
EFMP determines if that record is present in the Temporary Record Buffer; if it is, EFMP simply 
transfers the data in the user's record buffer to the Temporary Record Buffer and flags it as "must 
be written." Each succeeding read or write is treated in the same manner until a logical record trans- 
fer occurs for which the record is not in main memory, or until the last record in the Temporary 
Record Buffer is logically written. In these cases, the EFMP must physically write the records in the 
Temporary Record Buffer (i.e., post them) on the disc. 

If the record is not present in main memory on a write request, EFMP locates the record on the 
disc and transfers it physically into the Temporary Record Buffer. The data to be written is then 
transferred from the user buffer to the Temporary Record buffer and flagged as "must be written." 
The read before write is necessary because records do not necessarily fall on sector boundaries in 
the disc. If a CLOSE or POST request occurs, all buffers flagged are written to the disc. 



Update-Writes vs. Append-Writes 

The purpose of an update-write is to change the contents of an existing record; the purpose of 
append-write is to add new records onto the end of a file. EFMP writes a record as an update-write 
whenever the record specified exists in a previously accessed section of a file. 

EFMP writes a record as an append-write whenever the record specified is beyond the previously 
accessed section of a file. In this case, EFMP automatically inserts zeros into all records (if any) 
between the highest record previously written and the new record. 



SETUP 

There are two prerequisites for EFMP. First, the EFMP EXEC modules must be included in 
DOS-Ill when the system is generated. Second, when DOS-Ill is running, the user must create 
EFMP areas on formatted DOS-Ill packs or cartridges. 
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An EFMP area is created by issuing a STORE, B directive in this format: 

:STORE,B,PNxxx,sectors 

where xxx is a unique decimal number, 

PNxxx is the unique pack number, and 

sectors is the number of sectors of the EFMP area. 



Note: EFMP changes the file from Type-B to Type-A during initialization 
(see "Initialize'''). 



WORD 



1 



CONTENTS 



first character 


second character 


third character 


fourth character 


fifth character 


(not used) 


starting relative sector 


file length (in records) 


record length (in words) 


security code 


user-supplied status 


highest record number accessed 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



BITS 



Figure 7-1. EFMP File Disc Directory Format 
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SECTION VIII 
EFMP EXEC Calls 



The method of communication between a user program and EFMP is through the standard DOS-Ill 
EXEC call format (discussed in Section III of this manual). 

One standard DOS-Ill request code (RCODE = 24) is reserved for EFMP requests. The DOS-Ill 
operating system combines this request code with an EFMP function number to determine which 
action the user EXEC call is requesting. The EFMP function numbers are one element in each of the 
EFMP EXEC calling sequences. 



FORMAT FOR EFMP EXEC CALLS 

In this section, only the Assembly language calling sequences are given for the EFMP EXEC calls. 
The methods for converting these calling sequences to FORTRAN or ALGOL are described in 
Section III. 

The EFMP EXEC calls described in this section are presented in ascending order, by EFMP function 
number. The STATUS EXEC call (EFMPF = 10) has several status function numbers: these are 
presented in ascending order, by status function number. 



Note: A complete list of EFMP error codes can be found in PART 5 of this manual, 
"Error Codes and Messages. " 
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EFMPF = 1 



DEFINE 



Purpose 

To define, before any other EFMP calls are made, the number of 16-bit words within the user 
program to be used by EFMP for its internal buffers and tables. 



Assembly Language 





JSB 


EXEC 




DEF 


*+9 




DEF 


RCODE 




DEF 


EFMPF 




DEF 


OPNTB 




DEF 


OPNSZ 




DEF 


TRBUF 




DEF 


NOTRB 




DEF 


TRBSZ 




DEF 


ERRNO 




return 




RCODE 


DEC 


24 


EFMPF 


DEC 


1 


OPNTB 


BSS 


n 


OPNSZ 


DEC 


n 


TRBUF 


BSS 


m 


NOTRB 


DEC 


P 


(NOTRB+1) 


DEC 


n 


TRBSZ 


DEC 


Q 


ERRNO 


BSS 


1 



Return address 

Request code 

EFMP function number 

Opened-file table address 

Opened-file table size 

Temp, record buffer address 

Number of temp, record buffers and number of 

active pack numbers 

Temp, record buffer size 

Error number 

Continue execution 



Opened-file table (n is the size) 

Size of opened-file table (in 16-bit words, 

see Comment 1) 

Beginning of temp, record buffers, see Comment 2 

No. of temp, record buffers, see Comment 2 

n = the maximum number of unique EFMP pack 

numbers active (MAXPK), see Comment 4 

Size of each temp, record buffer (in sectors) 

Return point for error codes 



Comments 

1 



The size of the Opened-file table (n) can be calculated by this formula: 
n = 4*(MAXPK)+ 3*(NOTRB)+16*(Max. no. of files to be opened) 

The minimum size of this table is 128 words. This allows approximately seven files to be 
opened concurrently. 
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EFMPF = 1 



2. There must be at least one temporary record buffer and it must be at least two sectors long 
(256 words). There may, however, be more buffers and they may be more than two sectors 
in size. All of the space for these buffers must be allocated starting at the location TRBUF. 
Increasing the number of buffers allows disc efficiency to be increased by assigning a buffer 
exclusively to one file. Increasing the size of each buffer increases the speed of disc accessing 
by allowing more than one sector to be transferred per disc access. 

The total size of the Temp. Record Buffers (m) can be calculated by the following formula: 
m = NOTRB * TRBSZ * 128 

(The minimum value for TRBSZ is 2.) 

3. All the tables and buffers are fixed by DEFINE until the end of a program, or until another 
DEFINE. Each time a DEFINE occurs, all information contained in tables and buffers is lost, 
all pointers are reset, and EFMP assumes a fresh start. At the end of each program, DOS-Ill 
calls EFMP to perform a POST on any records flagged as "must be written." 

4. MAXPK indicates the maximum number of unique EFMP pack numbers a user will have 
active at any one time. A pack number is active when one or more of its files are opened by 
a user through an OPEN call (or for PN000 through a CREATE call). 
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EFMPF = 2 



CREA TE 



Purpose 

To set up a directory on disc with all of the information necessary to create a file that can be 
accessed at a later time. 



Assembly Language 





JSB 


EXEC 




DEF 


*+9 




DEF 


RCODE 




DEF 


EFMPF 




DEF 


FNAME 




DEF 


PAKNO 




DEF 


FLGTH 




DEF 


RLGTH 




DEF 


SCODE 




DEF 


ERRNO 




return 




RCODE 


DEC 


24 


EFMPF 


DEC 


2 


FNAME 


ASC 


l_/- *V*VvV AA 


PAKNO 


DEC 


p 


FLGTH 


DEC 


Q 



RLGTH 

SCODE 

(SCODE+1) 

ERRNO 



DEC r 

OCT s 

OCT t 

BSS 1 



Return address 

Request code 

EFMP function number 

File name 

Pack number 

File length (in records) 

Record length (in words) 

Security code and user status 

Error number 

Continue execution 



xxxxx is the name to be applied to the file 

(first two characters cannot be zero or 1 77400 8 ) 

p is the pack number, see Comments 

q is the number of records in the file; 

(1 < q< 32,767) 

r is the number of words in a record; 

r must be less than or equal to 1/2 the size 

of the temp, record buffer 

s is any 16-bit combination to be checked by EFMP 

during OPEN and DESTROY 

t is any 16-bit combination of status information 

desired by the user (referred to as USTAT elsewhere) 

Return point for error codes 
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EFMPF = 2 



Comments 

1. If PAKNO is a number between 1 and 999 it indicates the EFMP area in which the file is to 
be created. When EFMP creates a file, it reserves the necessary area on the disc after the last 
previous file generated. No attempt is made to search for an area between files. If PAKNO is 
equal to -1, the file is to be created in any EFMP area that is available. 

2. If PAKNO equals zero, the file is placed on the Work Area of the disc and no area will be 
reserved in the EFMP areas. When such a temporary file is created, the only directory in- 
formation that is maintained is in the Opened-File Table. A disc-based directory is not main- 
tained. Also, since the directory information is established in main memory during the 
CREATE function, the OPEN function is not required. The only reason for using an OPEN 
call for a temporary file is to assign it to a specific Temporary Record Buffer or to change 
the starting record number to a value other than 1. If no OPEN call is given, the first 
Temporary Record Buffer is used. 

3. When the Work Area is used for temporary files, EFMP reserves this whole area and identifies 
it as PNOOO. In order to keep PNOOO from using the entire Work Area, the user must enter a 
STORE,B,PN000 directive for the system disc with the desired number of sectors. When 
EFMP has terminated, the user should PURGE the file PNOOO from the Work Area. 
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EFMPF = 3 



DESTROY 



Purpose 

To eliminate the directory information for a particular file from main memory and the disc. The 
user must specify the correct security code for the file. The disc area is repacked only for temporary 
files. To repack the EFMP areas use the REPACK EFMP call. 



Assembly Language 





JSB 


EXEC 






DEF 


*+7 


Return address 




DEF 


RCODE 


Request code 




DEF 


EFMPF 


EFMP function code 




DEF 


FNAME 


File name 




DEF 


PAKNO 


Pack number 




DEF 


SCODE 


Security code 




DEF 


ERRNO 


Error number 




return 




Continue execution 


RCODE 


DEC 


24 




EFMPF 


DEC 


3 




FNAME 


ASC 


J *v* 'V* •y ■>* 'V 
*_J y vv *A- *\> vV *\> 




PAKNO 


DEC 


n 


lfn = 0, then FN AM. 



SCODE 



ERRNO 



OCT s 



BSS 



(if n> 1 and n < 999, FNAME is to be located in 
this EFMP area; if n = -1, EFMP searches all of its 
areas until it finds a file that matches FNAME) 
s is the security code for the file established by the 
CREATE EFMP call; security code ignored on 
temporary files 
Return point for error codes 
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EFMPF = 4 



OPEN 



Purpose 

To make a previously created file accessible by extracting the necessary file information from the 
disc directories and placing it in main memory. The number of files that can be opened at any one 
time is limited by the size of the Opened File Table (see DEFINE). 



Assembly Language 





JSB 


EXEC 






DEF 


*+9 


Return address 




DEF 


RCODE 


Request code 




DEF 


EFMPF 


EFMP function code 




DEF 


FNAME 


File name 




DEF 


PAKNO 


Pack number 




DEF 


RCDNO 


Record number 




DEF 


SCODE 


Security code 




DEF 


BUFNO 


Buffer number 




DEF 


ERRNO 


Error number 




return 




Continue execution 


RCODE 


DEC 


24 




EFMPF 


DEC 


4 




FNAME 


ASC 


O ,-y" *Y" A*" 'V* '"V* 




PAKNO 


DEC 


n 


If n = 0, the file is a t 



RCDNO 



DEC r 



SCODE 



OCT s 



BUFNO DEC b 



ERRNO BSS 1 



0, the file is a temporary file on the work area; 
if n is between 1 and 999, EFMP looks for FNAME in 
the appropriate area; if n = -1, EFMP searches all 
available areas for the requested file 
lfr = 0, EFMP sets the next record to be accessed 
(for sequential READS or WRITES) to the highest 
record previously accessed + 1. Otherwise, r can be 
any number between 1 and the maximum record 
number contained in the file. This allows sequential 
access to be initialized at any record, 
s is the security code established by the CREATE 
call. It must match. 

b must be a number between 1 and the maximum 
number of Temp. Record Buffers available. For 
any other number, EFMP uses 1 
Return point for error codes 
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EFMPF = 5 



CLOSE 



Purpose 

To remove information about a particular file from the Opened-File Table. This allows an additional 
file to be opened. Also, CLOSE updates the user status information (USTAT) and the highest record 
accessed on the disc. 



Assembly Language 



JSB 

DEF 

DEF 

DEF 

DEF 

DEF 

DEF 

return 



EXEC 
*+6 

RCODE 
EFMPF 

FNAME 
USTAT 
ERRNO 



Return address 

Request code 

EFMP function number 

File name 

User status 

Error number 

Continue execution 



RCODE 
EFMPF 
FNAME 
USTAT 

ERRNO 



DEC 24 

DEC 5 

OCT u 

BSS 1 



See Comment 2 

User status information (any 16-bit combination) to 
be written into the disc directory for the file 
Return point for error codes 



Comments 

1. If a CLOSE is requested for a temporary file, the directory information in the Opened-File 
Table is deleted and the Work Area is automatically repacked. If a file has been copied to the 
Work Area, the user status (USTAT) and highest record assessed are not updated on the 
original copy of the file. 

2. To CLOSE all files in the Opened-File Table set the first word of FNAME equal to a binary 
zero. 
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EFMPF = 6 



READ 



Purpose 

To retrieve a specified record (random access) or the next record (sequential access) from a file 
that has previously been opened and written. 



Assembly Language 



JSB EXEC 

DEF *+7 Return address 

DEF RCODE Request code 

DEF EFMPF EFMP function code 

DEF FNAME File name 

DEF RCDNO Record number 

DEF BUFFR Buffer for data 

DEF ERRNO Error number 

return Continue execution 



RCODE 
EFMPF 
FNAME 
RCDNO 

BUFFR 

ERRNO 



DEC 24 

DEC 6 

/lot/ tjyOCOCOCX 

DEC n 

BSS m 

BSS 1 



n is a record number between 1 and 32,767. For 
sequential access and backspacing, see Comments, 
m is the length of the buffer in words. It must be 
at least the record length. 
Return point for error codes 



Comments 

If RCDNO = 0, a sequential read or write is implied. This feature provides the program with the 
next record available relative to the last read or write performed (or OPEN operation). If RCDNO 
is a negative number, it specifies a backspace, relative to the current record (last record accessed 
plus 1), before the read or write. If an attempt is made to backspace the record number indicator 
to a value less than one, the EFMP issues an error and terminates the read or write. Unless needed, 
care should be taken so as not to backspace the record number indicator beyond the range of 
records held in the Temporary Record Buffer at that time, since this will initiate a posting oper- 
ation and a physical disc access. 
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EFMPF = 7 



INITIALIZE 

Purpose 

To initialize an EFMP area previously created by means of a DOS-Ill STORE directive. 

Assembly Language 





JSB 


EXEC 






DEF 


*+6 


Return address 




DEF 


RCODE 


Request code 




DEF 


EFMPF 


EFMP function number 




DEF 


PAKNO 


Pack number 




DEF 


DIRSZ 


Directory size 




DEF 


ERRNO 


Error number 




return 




Continue execution 


RCODE 


DEF 


24 




EFMPF 


DEC 


7 




PAKNO 


DEC 


P 


(Kp< 999) 


DIRSZ 


DEC 


n 


(n = number of entries, < 


ERRNO 


BSS 


1 


Return point for error c 



Comments 

1. Pack number PNO00 cannot be initialized. 

2. The directory occupies the first sector(s) of the EFMP area. 

The number of sectors allocated to a directory is determined as follows: 

The variable n is used to calculate the number of sectors to be reserved for the directory. It does 
not indicate the maximum number of file entries allowed in the directory. If the nth file entry 
does not completely fill the last sector of the directory, the space remaining may be used to con- 
tain additional file entries. 



#Sectors = 



(l + n)*9 
128 



(add 1 to #Sectors if remainder is > zero) 
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EFMPF = 8 



WRITE 



Purpose 

To write into a specified record (random access) or into the next record (sequential access) of a 
file that has previously been opened. 



Assembly Language 





JSB 


EXEC 






DEF 


*+7 


Return address 




DEF 


RCODE 


Request code 




DEF 


EFMPF 


EFMP function number 




DEF 


FNAME 


File name 




DEF 


RCDNO 


Record number 




DEF 


BUFFR 


Buffer for data 




DEF 


ERRNO 


Error number 




return 




Continue execution 


RCODE 


DEC 


24 




EFMPF 


DEC 


8 




FNAME 


ASC 


tj a •A' *^ fc^ *V *A* 




RCDNO 


DEC 


n 


Same as for the READ 1 


BUFFR 


BSS 


m 


Same as for READ 


ERRNO 


BSS 


1 


Return point for error c 
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EFMPF = 9 



RESET 



Purpose 

To reset the highest record accessed pointer for a file to a lower value. The information beyond the 
pointer is lost. The file must be open before it can be reset. (PAKNO below provides an additional 
check.) 



Assembly Language 





JSB 


EXEC 






DEF 


*+7 






DEF 


RCODE 


Request code 




DEF 


EFMPF 


EFMP function code 




DEF 


FNAME 


File name 




DEF 


PAKNO 


Pack number 




DEF 


RCDNO 


Record number 




DEF 


ERRNO 


Error number 




return 




Continue execution 


RCODE 


DEC 


24 




EFMPF 


DEC 


9 




FNAME 


ASC 


fj j *^ *»V *V *A* *A* 




PAKNO 


DEC 


n 


lfn = 0, EFMP searci 



RCDNO 



ERRNO 



DEC m 



BSS 



desired file name; if n is a number between 1 and 999, 
EFMP searches EFMP area PNn to find the desired 
file name; if n = -1, EFMP searches all EFMP areas 
m is a number between and 32,767 to which the 
highest record accessed pointer will be set ( m must 
be lower than the current value) 
Return point for error codes 
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EFMPF = 10 



STA TUS 



Purpose 

To allow the user program access to various types of status information relative to EFMP. Several 
separate status functions (identified by unique Status Function Numbers) are provided; all have 
basically the same form of calling sequence, but they vary in the parameters used. 



Assembly Language 



JSB 


EXEC 




DEF 


*+9 


Return address 


DEF 


RCODE 


Request code 


DEF 


EFMPF 


EFMP function code 


DEF 


FSTAT 


Status function number 


DEF 


FNAME 


File name 


DEF 


PAKNO 


Pack number 


DEF 


DUMMY 


Not used 


DEF 


STATB 


Status buffer 


DEF 


ERRNO 


Error number 


return 




Continue execution 



Note: 



RCODE 


DEC 


EFMPF 


DEC 


DUMMY 


BSS 



Above is the general format for Status EFMP calls. The use 

and meaning of each parameter in the calling sequence varies 

from status call to status call. The parameters for each call 

are given separately, below. Common to all status functions 

are 

24 

10 

1 
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FSTAT = 1 



STATUS 



Purpose 

To provide the user with all information, except the security code, contained in the directory for 
a file. 



Parameters 



FSTAT 

FNAME 

PAKNO 



DEC 1 
DEC m 



STATB 



ERRNO 



BSS 10 



BSS 1 



If m = 0, EFMP searches the Work Area for the 
requested file. If m is between 1 and 999, EFMP 
searches the EFMP area of that pack number. For 
m = -1, EFMP searches all available EFMP areas 
for the requested file. 

The pack number is returned in the first word if 
PAKNO = -1. The remaining nine words will 
receive the directory status information in the 
same format as the directory itself (see Figure 7-1). 
Return point for error code. 
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FSTAT = 2 



STATUS 



Purpose 

To determine if a file is open. 



Parameters 






FSTAT 


DEC 


2 


FNAME 


ASC 


O^XXXXX 


PAKNO 


OCT 





STATB 


BSS 


2 



ERRNO 



BSS 



Not used 

The first word returns the pack number if the 

file is open. The second word returns a value 

of if the file is open or 1 if the file is not 

open. 

Return point for error codes. 
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FSTAT=3 



STA TUS 



Purpose 

To check the security code of a file. 



Parameters 






FSTAT 


DEC 


3 


FNAME 


ASC 


3,xxxxx 


PAKNO 


DEC 


m 


STATB 


BSS 


3 



Same as function number 1 
The first word returns the pack number if 
appropriate. The second word is used by the 
user program to give the security code to be 
checked. The third word returns if the code 
checks or 1 if it does not check. 
ERRNO BSS 1 Return point for error codes. 
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FSTAT = 4 



STA TUS 



Purpose 

To determine the number of available full sectors left between the highest record accessed in a file 
and the end of the file. 



Parameters 






FSTAT 


DEC 


4 


FNAME 


ASC 


fj • *A* *\* vV *A» vV 


PAKNO 


DEC 


m 


STATB 


BSS 


2 


ERRNO 


BSS 


1 



Same as function number 1 

The first word returns the pack number if 

appropriate. The second word returns the 

number of sectors available. 

Return point for error codes. 
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FSTAT = 5 



STA TUS 



Purpose 

To determine the number of available sectors left between the last file in an EFMP area and the 
end of the EFMP area. 



Parameters 



FSTAT DEC 5 

FNAME OCT 

PAKNO DEC m 

STATB BSS 2 



ERRNO 



BSS 



Not used 

Same as function number 1, but cannot equal -1 

The first word must be present, but is not used. 

The second word returns the number of sectors 

available. 

Return point for error codes. 
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FSTAT = 6 



STATUS 



Purpose 

To obtain the name of the nth file in an EFMP area where n is an integer between 1 and the 
maximum number of files in an EFMP area. 



Parameters 






FSTAT 


DEC 


6 


FNAME 


BSS 


3 


PAKNO 


DEC 


m 


STATB 


DEC 


n 


ERRNO 


BSS 


1 



Return point for file name or all zeroes if no 

file is present 

m is a number between 1 and 999 

n indicates the nth file 

Return point for error codes 
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FSTAT = 7 



STATUS 



Purpose 

To obtain the name of the nth pack number on a specific subchannel where n is an integer (speci- 
fying the ordinal position of the pack number) between 1 and the maximum number of pack 
numbers on a subchannel. 



Parameters 






FSTAT 


DEC 


7 


FNAME 


DEC 


m 


PAKNO 


BSS 


1 


STATB 


DEC 


n 


ERRNO 


BSS 


1 



m = the desired subchannel 

On return, FNAME is zero if the EFMP area of 

the pack number is initialized and 1 if the EFMP 

area of the pack number is not initialized. 

Return point for the pack number 

n indicates the nth pack number. 

Return point for error codes. 
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EFMPF = 11 



REPACK (PURGE) 



Purpose 

To repack the existing files on an EFMP area(s), removing empty spaces left when files have been 
destroyed. 



Assembly Language 



JSB 


EXEC 




DEF 


*+5 




DEF 


RCODE 


Request code 


DEF 


EFMPF 


EFMP function code 


DEF 


PAKNO 


Pack number 


DEF 


ERRNO 


Error number 


return 




Continue execution 



RCODE 


DEC 


24 


EFMPF 


DEC 


11 


PAKNO 


DEC 


n 


ERRNO 


BSS 


1 



For n between 1 and 999, only the specified EFMP 
area is repacked; for n = -1, all the EFMP areas 
available to EFMP are repacked 
Return point for error codes 



CA UTION: IF THE EFMP DISC DIRECTOR Y CONTAINS A LARGE NUMBER 
OF FILES AND THE SIZES OF THE TEMPORAR Y RECORD 
BUFFERS ARE SMALL, REPACKING MA Y REQUIRE CONSIDER- 
ABLE TIME. THEREFORE, REPACK SHOULD BE PERFORMED 
WHEN SUFFICIENT TIME IS AVAILABLE. UNDER NO CIRCUM- 
STANCES SHOULD AN ABORT BE PERFORMED DURING A 
REPACK. 
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EFMPF = 12 



COPY 



Purpose 

To transfer a copy of an opened file and its directory from an EFMP area to the Work Area of 
DOS-Ill, from one EFMP area to another EFMP area or from the Work Area to an EFMP area. 



Assembly Language 





JSB 


EXEC 






DEF 


*+6 






DEF 


RCODE 


Request code 




DEF 


EFMPF 


EFMP function code 




DEF 


FNAME 


File name 




DEF 


PAKNO 


Pack number 




DEF 


ERRNO 


Error number 




return 




Continue execution 


RCODE 


DEF 


24 




EFMPF 


DEC 


12 




FNAME 


ASC 


fj m *\ *A- *A* *\> *A* 


See Comment 1 


PAKNO 


DEC 


n 


lfn = 0, EFMP copie 



ERRNO 



BSS 



if n is between 1 and 999, EFMP copies the file 
into the specified EFMP area; if n is between -1 
and -999, EFMP copies the file from the Work 
Area to an EFMP area specified by the 10's 
complement of n (see Comment 2) 
Return point for error codes 



Comments 

1. Remember that a file must be opened before it can be copied. This is necessary to determine 
from which pack to copy the file. When a file has been copied to the Work Area, all reads and 
writes referencing that file use the Work Area version until the file is closed. (Files copied 
from the Work Area to an EFMP area continue to use the Work Area version for reads and 
writes.) Temporary copies of files do not have security codes. Therefore, files copied from the 
Work Area to a pack have a security code of 0. When a file is copied from pack to pack, the 
original security code is retained. See "CLOSE" for further notes on Work Area files. 
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EFMPF = 12 



2. If there is already a file with the same name in the destination EFMP area directory, an error 
code is returned and the copy is aborted. In this case, the user can first destroy the name in 
the destination EFMP area, and then perform the copy again. 

3. When copying from one EFMP area to another EFMP area not on the drive (and only a single 
removable pack is available), EFMP automatically requests that the user continually swap 
packs until the entire file has been copied. EFMP outputs: 

INSERT DESTINATION [SOURCE] PACK AND PRESS R UN. 

and halts the computer with 102076 in the DISPLAY register. 

After the user inserts the appropriate pack and presses RUN, a check is made to determine if 
the proper pack has been entered. If EFMP cannot find the correct pack, the message is re- 
peated. To allow the user an orderly exit in case the correct pack is not available, the following 
question is asked after each question: 

ENTER CORT 

where C means to continue copying, and 

T means to terminate the copy and return to the program. 

4. Care must be taken to insert the original pack (if it has been removed during the copy function) 
into its original subchannel. 
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EFMPF = 13 



CHANGE FILE NAME 



Purpose 

To change a file name (file need not be opened). 

Assembly Language 





JSB 


EXEC 






DEF 


*+7 






DEF 


RCODE 


Request code 




DEF 


EFMPF 


EFMP function code 




DEF 


FNAME 


File name 




DEF 


PAKNO 


Pack number 




DEF 


SCODE 


Security code 




DEF 


ERRNO 


Error number 




return 




Continue execution 


RCODE 


DEC 


24 




EFMPF 


DEC 


13 




FNAME 


ASC 


c* * *A> vv *K> •A* •A' 


Current file name 




ASC 


3,zzzzz 


New file name 


PAKNO 


DEC 


n 


n = 0, indicates that I 



SCODE 
ERRNO 



OCT m 
BSS 1 



if n is between 1 and 999, n indicates the EFMP 
area containing the file; if n = -1, EFMP searches 
all available EFMP areas for the current file name 
Security code, see CREATE 
Return point for error codes 
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EFMPF = 14 



POST 



Purpose 

To physically write on the disc all buffers that have been flagged as "must be written" in the 
Temporary Record Buffer. (That is, convert all outstanding logical writes into physical writes.) 



Assembly Language 





JSB 


EXEC 






DEF 


*+4 






DEF 


RCODE 


Request code 




DEF 


EFMPF 


EFMP function code 




DEF 


ERRNO 


Error number 




return 




Continue execution 


RCODE 


DEC 


24 




EFMPF 


DEC 


14 




ERRNO 


BSS 


1 


Return point for errc 



Comments 

The POST operation updates the highest record accessed pointer in the disc directories, but not 
the user status word (USTAT). 
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SECTION IX 
EFMP Utility Program 



The EFMP Utility Program (UTIL) allows the user to access most of the EFMP functions through 
the keyboard. UTIL accepts commands or directives from the operator and converts these into 
EFMP calling sequences. After EFMP has processed the call, UTIL reports back (to the operator) a 
successful operation or an EFMP error. 

This section describes how to initiate the UTIL program using the DOS-Ill PROG directive and 
then describes the following UTIL commands (presented in alphabetic order): 



BRIEF 

CHANGE 

CLOSE 

COPY 

CREATE 

DESTROY 

END 

INITIALIZE 

OPEN 

POST 

REPACK 

RESET 

STATUS-1 

STATUS-2 

STATUS-3 

STATUS-4 

STATUS-5 

STATUS-6 

STATUS-7 



All are EFMP functions, except BRIEF and END, 
which are UTIL program functions. 



Note: UTIL requires the FORTRAN IV version of the Formatter program to 
operate properly. 
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:PROG,UTIL 



Purpose 

To initiate execution of the UTIL program. 

Format 

.PROG, UTIL,n 

where n = to print a list of commands or 
n f to skip printing the list. 

List of commands message (all parameters are decimal): 

/INI,PAKNO,DIRSZ 

/CRE,FNAME,PAKNO,FLGTH,RLGTH,SCODE, USTA T 

/DES,FNAME,PAKNO,SCODE 

/OPE,FNAME,PAKNO,R CDNO,SCODE 

/CLO,FNAME, USTA T 

/RES,FNAME,PAKNO,RCDNO 

/STA,DF,FNAME,PAKNO 

/STA,FO,FNAME 

/STA,SC,FNAME,PAKNO,SCODE 

/STA,LR,FNAME,PAKNO 

/STA,LF,PAKNO 

/STA,NF,PAKNO,STA TB 

/STA,AP 

/REP,PAKNO 

/COP,FNAME,PAKNO 

/CHA,FNAMl,FNAM2,PAKNO,SCODE 

/POS 

/BRI, FNAME,SCODE 

/END 
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UTIL begins by outputting a message to indicate that it is ready for a directive: 
UTIL READY 

After it processes the directive, UTIL outputs the results of the operation (where appropriate) or 
any error codes that may have been returned by EFMP. When it is ready for another directive, 
UTIL outputs 

UTIL READY 

If an incorrect directive is entered, UTIL outputs 

ILLEGAL OPERATION 
UTIL READY 

UTIL is terminated when the operator inputs the command /END. 

UTIL outputs any error messages on the system console; normal output is output on the list device. 
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BRIEF 



Purpose 

To increase or decrease the amount of disc storage reserved for a file. BRIEF is a UTIL program 
function, not an EFMP function. 



Format 

/BRI, fname,scode 

fname is the name of the file, and 
scode is the security code of the file. 

BRIEF first outputs the status of the file: 

A VAILABLE RECS. = m RECORDS USED = r 

NEW RECORD COUNT? 

The operator inputs either: 

IE to terminate the command and prepare UTIL for more commands, 

or 
n to change the available record count to n 

BRIEF stores the contents of fname on the Work Area, destroys the current file, repacks the EFMP 
area, and creates and opens a new file. The contents of fname are transferred from the Work Area 
to the new file and BRIEF prints out a message: 

A VAILABLE RECS. = n RECORDS USED = r 

BRIEF then terminates. 

Comment 

BRIEF creates and uses a temporary file named "AAAAAA" (all blanks). 
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CHANGE 



Purpose 

To change the name of a file (i.e., to invoke the CHANGE FILE NAME function of EFMP). 

Format 

/CHA,fnaml,fnam2,pakno,scode 

fnaml is the current file name 
fnam2 is the new file name. 

See CHANGE FILE NAME EFMP CALL for explanation of other parameters. 

EXAMPLE 

/CHA ,L OB 70,XXXXX, 120,0 

Example print-out: 

FILE LOB70 OLD FILE 
FILE XXXXX NEW FILE 
THE FILE IS ON PA CK# 1 20 
THE SECURITY CODE IS 



9-5 



CLOSE 

Purpose 

To close a previously opened file (i.e., to invoke the CLOSE function of EFMP). 

Format 

/CLO,fname, usta t 

See CLOSE EFMP CALL for explanation of parameters. Note, however, that all the files in the 
Opened-File Table cannot be closed by setting the first word of FNAME (in the CLOSE calling 
sequence) to a binary zero. 

EXAMPLE 

/CLO, LOB 70,0 

Example print-out: 

FILE LOB70 CLOSED 

THE USER STA TUS WORD IS 
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COPY 

Purpose 

To copy a file (i.e., to invoke the COPY function of EFMP). 

Format 

/COP,fname,pakno 
See COPY EFMP CALL for explanation of parameters and messages. 

EXAMPLE 

/COP,LOB70,120 

Example print-out: 

FILE LOB70 COPIED 

THE FILE IS TEMPORAR Y IN WORK AREA 

FILE LOB70 COPIED 

THE FILE IS ON PA CK# 1 20 
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CREATE 



Purpose 

To create a new file (i.e., to invoke the CREATE function of EFMP). 

Format 

/CRE,fname,pakno,flgth,rlgth,scode,u$tat 
See CREATE EFMP CALL for explanation of parameters. 

EXAMPLE 

/CRE,CO J 20,8,8,0,0 

Example print-out: 

FILE CO CREATED 

THE FILE IS ON PA CK# 1 20 

THE FILE LENGTH IS 8 RECORDS 

THE RECORD LENGTH IS 8 WORDS 

THE SECURITY CODE IS 

THE USER STATUS WORD IS 
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DESTROY 



Purpose 

To destroy a file by eliminating its directory entry (i.e., to invoke the DESTROY EFMP function). 

Format 

/DES,fname,pakno,scode 
See DESTROY EFMP CALL for explanation of parameters. 

EXAMPLE 

/DES, CO, 120,0 

Example print-out: 

FILE CO DESTROYED 
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END 



Purpose 

To terminate the operation of the UTIL program. END is an UTIL program function, not an EFMP 
function. 



Format 

/END 
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INITIALIZE 



Purpose 

To initialize an EFMP area previously allocated space by means of a DOS-Ill STORE directive. 

Format 

/INI,pakno, dirsz 
See INITIALIZE EFMP CALL for explanation of parameters. 

EXAMPLE 

/INI, 100,20 

Example print-out: 

PACK #100 INITIALIZED 



9-11 



OPEN 

Purpose 

To OPEN a previously CREATED file (i.e., to invoke the OPEN function of EFMP). 

Format 

/OPE,fname,pakno,rcdno,scode 
See OPEN EFMP CALL for explanation of parameters. 

EXAMPLE 

/OPE,LOB70,1 20,1,0 

Example print-out: 

FILE LOB70 OPENED 
THE FILE IS ON PACK# 1 20 
THE RECORD # IS 1 
THE SECURITY CODE IS 
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POST 



Purpose 

To post files (i.e., to invoke the POST function of EFMP). 

Format 

/POS 

Example print-out: 

ALL FILES POSTED 
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RESET 

Purpose 

To reset the highest record number accessed for a file (i.e., to invoke the RESET function of EFMP). 

Format 

/RES,fname,pakno,rcdno 
See RESET EFMP CALL for explanation of the parameters. 

EXAMPLE 

/RES,LOB70,120,0 

Example print-out: 

FILE LOB70 RESET 
THE FILE IS ON PACK# 120 
THE RECORD # IS 
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REPACK 



Purpose 

To repack existing EFMP areas (i.e., to invoke the REPACK EXEC CALL function of EFMP). 

Format 

/REP,pakno 
See REPACK EFMP CALL for explanation of parameters. 

EXAMPLES 

/REP,42 (repacks EFMP area in pack 42) 
/REP, -1 (repacks all EFMP areas) 

Example print-out: 

PACK # 42 REPACKED 

or 
ALL PACKS AVAILABLE REPACKED 
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STATUS-1 



Purpose 

To print out directory information about a file (i.e., to invoke STATUS function number 1 of 
EFMP). 



Format 

/STA,DF,fname,pakno 
See STATUS EFMP CALL (FSTAT = 1) for explanation of the parameters and results. 

EXAMPLE 

/STA,DF,LOB70,120 

Example print-out: 

FILE LOB70 STATUS 
THE FILE IS ON PA CK# 1 20 
STAR TING TRA CK # IS 6 
STARTING SECTOR # IS 9 
THE FILE LENGTH IS 12 RECORDS 
THE RECORD LENGTH IS 1 28 WORDS 
THE USER STATUS WORD IS 
HIGHEST RECORD # A CCESSED IS 
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STATU S-2 



Purpose 

To determine if a file is OPEN (i.e., to invoke STATUS function number 2 of EFMP). 

Format 

/STA,FO,fname 
See FSTAT = 2 for explanation of the parameters and results. 

EXAMPLE 

/STA,FO,LOB70 

Example print-out: 

FILELOB70 STATUS 
FILE IS OPEN 
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STATU S-3 



Purpose 

To check the security code of a file (i.e., to invoke STATUS function number 3 of EFMP). 

Format 

/STA,SC,fname,pakno,scode 

See FSTAT=3 for explanation of parameters and results. 

EXAMPLE 

/STA,SC,LOB70,120,0 

Example print-out: 

FILE LOB70 STATUS 
THE FILE IS ON PA CK# 120 
THE SECURITY CODE IS 
CODE CHECKS 



Note: The security code returned is a restatement of the security code 
entered; it is not necessarily the correct security code. 
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STATUS-4 



Purpose 

To determine the number of available full sectors left between the highest record accessed in a file 
and the end of the file (i.e., to invoke STATUS function number 4 of EFMP). 



Format 

/STA,LR,fname,pakno 
See FSTAT=4 for explanation of parameters and results 

EXAMPLE 

/STA,LR,LOB70,120 

Example print-out: 

FILE LOB 70 STATUS 
THE FILE IS ON PA CK# 120 
#0F A VAILABLE SECTORS IS 1 2 
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STATU S-5 



Purpose 

To determine the number of available sectors left between the last file in an EFMP area and the 
end of the EFMP area (i.e., to invoke STATUS function number 5 of EFMP). 



Format 

/STA,LF,pakno 
See FSTAT=5 for explanation of parameters and results. 

EXAMPLE 

/ST A, LF, 120 

Example print-out: 

FORPACK# 120 

#OFA VAILABLE SECTORS IS 461 
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STA TUS-6 



Purpose 

To obtain the name of the nth file in an EFMP area where n is an integer between 1 and the 
maximum number of files in an EFMP area (i.e., to invoke STATUS function number 6 of EFMP). 



Format 

/STA,NF,pakno,statb 
See FSTAT=6 for explanation of parameters and results. 

EXAMPLE 

/STA,NF,120,1 

Example print-out: 

FILE LOB70 STATUS 
THE FILE IS ON PA CK# 1 20 
FILE # 1 IN THE DIRECTOR Y 
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STA TUS-7 



Purpose 

To obtain the name of the nth pack number on a specific subchannel where n is an integer 
(specifying the ordinal position of the pack number) between 1 and the maximum number of 
pack numbers on a subchannel. 



Format 

/STA,AP,subch,statb 
See FSTAT = 7 for explanation of parameters and results. 

EXAMPLE 

/STA, AP, 1,1 

Example print-out: 

PACK #1 20 IS A VAIL ABLE AND INITIALIZED 
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PART 3 
Generating and Loading DOS-Ill 



SECTION X 
Generating DOS-Ill 



HP 24307B DOS-Ill Disc Operating System software must be generated and then loaded into the 
computer's memory before DOS-Ill system operation is possible. Generating a DOS-IH system con- 
sists of two operations: 

1. Configuring the system to the available hardware. 

2. Storing the configured system on disc memory. 

In addition, the discs included in the system must be formatted before they can be used by DOS-Ill. 

This section describes the procedures required to format a disc and to generate DOS-Ill system soft- 
ware. Both disc formatting and system generation are performed using a stand-alone program, DSGEN. 

Depending on the type of moving-head disc device selected for the DOS-Ill system, generation can be 
performed either from relocatable modules and drivers punched on paper tape or contained on a master 
disc cartridge. Systems including an HP 7901, HP 2883, or HP 2884 disc device initially must be 
generated from paper tape. Systems including an HP 7900 disc device are delivered with a master 
disc cartridge (HP part number 24307-13001) labeled DSGEN. The DSGEN disc cartridge con- 
tains a DOS-Ill software system together with a set of relocatable modules and drivers. The cartridge 
may be used to generate DOS-Ill software. A procedure for preparing to generate DOS-Ill software 
from the DSGEN disc cartridge is described later in this section (see "DSGEN Disc Cartridge Sys- 
tem Generation"). 



DSGEN 

DSGEN (the DOS-Ill System Generator) is an absolute program which is loaded into main memory: 
1) by the paper tape portion of the main-memory loader, BMDL, when using an HP 2100A/S com- 
puter or, 2) by the Bootstrap loaders contained in either the paper tape loader ROM or in the disc 
loader ROM when using an HP 21MX computer. Since DSGEN input/output is independent of the 
DOS-Ill system it generates, the I/O operation of DSGEN requires SIO drivers which are distributed 
with the DOS-Ill software. The SIO drivers must be configured to the user's hardware configuration. 
A copy of the configured DSGEN program can be punched on paper tape using SIO System Dump, 
if desired. SIO drivers and SIO System Dump are absolute programs — not part of DOS-Ill — needed 
only for DSGEN operation. An optional utility program which uses SIO drivers is the Prepare Tape 
System (PTS). PTS can be used to transfer relocatable modules from paper tape to magnetic tape to 
expedite the DSGEN program input phase. DSGEN has two independent functions: 
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1. To format new disc cartridges (or packs). 

2. To generate a DOS-Ill software system that fits the user's main-memory size, I/O equipment, 
and programming needs. 



DSGEN CONFIGURATION FROM PAPER TAPE 

DSGEN is executed in a Software Input/Output environment to generate DOS-Ill. First, ensure 
that equipment power is on and disc storage is unprotected (Disc Protect Override or Format 
enabled). At this point in DSGEN configuration, the procedure for loading paper tape depends on 
the computer being used. 

HP 2100A/S 

The main-memory loader, BMDL, is used to load programs from paper tape into memory. BMDL 
is described in detail in Section XI. A simplified procedure follows: 

A. Place the paper tape into the paper tape reader and press READ to ready the reader. 

B. On the computer front panel, set the P-register to the BMDL starting address 37700 8 for 16K 
words of memory; 57700 8 for 24K words; or 77700 8 for 32K words. 

C. Press PRESET (INTERNAL and EXTERNAL); then press RUN. After a successful load, the 
computer will halt with 102077 8 in the display register. 



HP 21MX 

The HP 21MX processor is equipped with a paper tape loader ROM, the contents of which are 
equivalent to the Basic Binary Loader portion of the BMDL used on HP 2100A/S computers. The 
contents of the ROM must be loaded into memory before the drivers or DSGEN (or any program 
on paper tape) can be placed into main memory. Use the following procedure to accomplish paper 
tape ROM loading. 

A. Press PRESET. 

B. Select the S-register for display. 

C. Press the CLEAR DISPLAY. 

D. Bits 15 and 14 of the Display Register must be 00 to select the paper tape loader ROM. 

E. Change bits 11 through 6 of the Display Register to the octal select code of the tape reader. 

Since bits 13, 12, and 5 through are not used in conjunction with the paper tape loader, 
they are ignored. 

F. Press STORE to store the contents of the Display Register in the S-register. 
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G. Press IBL to load the contents of the paper tape loader ROM into the uppermost 64 locations 
in memory. The computer halts with 102077 8 in the T-register. 

H. Place the DSGEN paper tape in the paper tape reader, press READ to ready the reader, and 
press RUN at the main processor. After a successful load, the computer halts with 102077 8 
in the T-register. 

To configure DSGEN (using either an HP 2100A/S or HP 21MX computer), proceed as follows: 

1. Specific SIO drivers must be configured before DSGEN can be executed. To configure a 
driver: 

a. Load the driver program into memory via the paper tape reader using the proper set of 
procedures from those described above (HP 21 OOA/S Steps A through C or HP 21MX 
Steps A through H). 

b. Set the I/O channel select code of the device (lower numbered select code if there are 
two I/O channels) in bits 5-0 of the switch register. 

c. Start the driver program by setting the P-register to address 2 8 ; then press RUN. Upon 
successful completion of the driver configuration, the computer will halt with 102077 8 
in the display register. 

2. Configure the SIO console driver (HP part no. 24127-60001) using Steps 1-a through 1-c. (If 
the console device is an HP 2754B teleprinter, switch register bit 15 must be set to one at 
Step 1-b.) 

3. If program input is to be from the paper tape reader, configure the SIO paper tape reader 
driver (HP part no. 20319-60001) using Steps 1-a through 1-c. 

4. If a high-speed paper tape punch is included in the system, configure the SIO punch driver 
(HP part no. 20320-60001) using Steps 1-a through 1-c. 

5. Load DSGEN via the paper tape reader using the appropriate procedure described above (HP 
21 00A/S Steps A through C or HP 21MX Steps A through H). 

6. If program input is to be from magnetic tape, configure the SIO magnetic tape driver (HP part 
no. 13022-60001) using Steps 1-a through 1-c. 

7. If the system includes a high-speed or console punch, a configured DSGEN can be punched on 
paper tape using the following procedure : 

a. Load the SIO System Dump program (HP part no. 20335-60001) via the paper tape 
reader using the procedure described in HP 21 00A/S Steps A through C or the procedure 
described in HP 21 MX Steps A through H. 

b. Set switch register bit 15 to one. 

c. Start the SIO System Dump program by setting the P-register to address 2 8 ; then press 
RUN. After tape punching is successfully completed, the computer will halt with 102077 8 
in the display register. For an additional copy of the configured DSGEN, press RUN. 
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8. If the disc or discs to be used by DOS-Ill have been formatted, DOS-Ill system generation can 
begin immediately. Proceed as follows: 

a. Set switch register bit 15 to zero. 

b. Set the P-register to DSGEN starting address 100 8 . 

c. Press RUN. DOS- III system generation dialog begins (see "Using DSGEN to generate 
DOS-Ill"). 

9. To format discs before executing system generation: 

a. Set switch register bit 15 to one. 

b. Set the P-register to DSGEN starting address 100 8 . 

c. Press RUN. The disc formatting dialog begins (see "Using DSGEN to Format Discs"). 

DSGEN Start-up 

To start either disc formatting or DOS-IH system generation from a configured DSGEN program 
(on paper tape) perform a standard paper-tape load. These procedures are described in HP2100A/S 
Steps A through C or in HP 21MX Steps A through H. Then proceed as follows: 

• For disc formatting: 

a. Set switch register bit 15 to one. 

b. Set the P-register to the DSGEN starting address 100 8 . 

c. Press RUN. The disc formatting dialog begins (see "Using DSGEN to Format Discs"). 

• For DOS-Ill system generation : 

a. Set switch register bit 15 to zero. 

b. Set the P-register to the DSGEN starting address 100 8 . 

c. Press RUN. DOS-Ill system generation begins at the initialization phase (see "Using 
DSGEN to generate DOS-IH"). 
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USING DSGEN TO FORMAT DISCS 



Before a fresh disc can be used in DOS-Ill, it must be formatted by DSGEN. System discs (including 
a possible User Area) are formatted during system generation, but dedicated user discs must be for- 
matted by running DSGEN again in a special mode. Formatting a disc involves assigning it a system 
generation code, reading every sector, clearing any existing user or system directory, and so forth. 
The result is an unlabeled user disc ready for use in DOS-Ill. The following operator responses are 
only examples, actual responses should be appropriate to the particular system being generated. 



Operating Instructions 

1. Turn on all equipment. 

2. Unprotect the disc (enable Disc Protect Override). 

3. Load a configured DSGEN using the main-memory resident BMDL or the paper tape loader 
ROM. (See "DSGEN Configuration and Start-up" in this section.) 

4. Set up a starting address at location 100 8 . 

5. Set switch register bit 15 equal to 1. 

6. Start the computer executing (press RUN). 

7. DSGEN asks for a decimal number to be written on the disc 

label. This number is used for identification SYS GEN CODE? 

Operator responds with a 1- to 4-digit decimal number 79 

8. DSGEN requests the octal channel number (select code) of 

the disc controller SYS DISC CHANNEL? 

Operator responds with the appropriate octal number 10 

9. DSGEN requests the type of disc storage DISC TYPE? 

Operator responds with 7900, 7901, 2883, or 2883B 

(A response of 2883 implies four subchannels per disc 

drive; 2883B implies two subchannels per disc drive.) 7900 

10. DSGEN requests the subchannel number (0 to 7) of the 

user disc to be formatted USER DISC SUBCHANNEL? 

Operator responds with a number between and 

7 inclusive 3 



10-5 



11. DSGEN requests that the disc be unprotected (if it is 

still protected) TURN ON DISC PROTECT OVERRIDE - PRESS RUN 

Operator unprotects the disc and starts the 
computer executing. 

12. DSGEN carries out formatting on the specified subchannel 
and halts with a code of 102007 8 . 

13. This procedure should be repeated for each proposed user disc. 

Operator can start the computer (press RUN) to format 

a new disc of the same type (switch bit 15 must still be 

equal to 1). 

DSGEN repeats from USER DISC SUBCHANNEL? 

Operator can set switch bit 15 equal to and start the 
computer (press RUN) to proceed to system generation. 
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USING DSGEN TO GENERATE DOS-Ill 



The operation of DSGEN involves four phases: 

1. INITIALIZATION PHASE. DSGEN requests specifications for DOS-Ill, including description 
of available disc space, memory, Time-base Generator channel, system generation code, system 
and user disc subchannels, and program input devices. 

2. PROGRAM INPUT PHASE. DSGEN reads the relocatable programs to be included in the sys- 
tem. The relocatable program modules can be input via paper tape, disc, or magnetic tape (the 
magnetic tape must be prepared off-line using the Prepare Tape System) . 

3. PARAMETER INPUT PHASE. Parameters to change EXEC modules or drivers from disc- to 
main-memory resident may be entered. The programs' NAM records are already set for a 
minimum main-memory system except that two console drivers have been included. DISCM, 
$EX30 (if EFMP is used), moving-head driver DVR31, and one console driver must be main- 
memory resident. 

4. DISC LOADING PHASE. DSGEN requests a specification of the base page linkage, and begins 
loading programs onto the disc in absolute format. Systems programs (i.e., the modules of 
DOS-HI) are loaded first, after which DSGEN requests information for the equipment table, 
device reference table (logical unit table), and interrupt table and proceeds to load the rest of 
the programs onto the disc. 



Restart 

If an error occurs during execution of any phase, the operator can restart that phase by restarting 
DSGEN at location 100 8 . 
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Initialization Phase 

During the initialization phase, DSGEN requests information necessary to begin generating the 
DOS-Ill. After each output on the system console, the operator responds by entering the required 
information terminated by a return linefeed. The following responses are typical. (The operator 
responses are only examples, actual responses should be appropriate to the particular system being 
generated.) 

1. DSGEN requests a decimal system generation code. This 
code is written in the label field of the system disc for 

identification SYS GEN CODE? 

Operator responds with a 1- to 4-digit decimal integer 79 

2. DSGEN requests the octal channel number (select code) of 

the disc controller SYS DISC CHNL? 

Operator responds with the high priority (low number) 

channel 14 

Note: BMDL requires that the SYS DISC CHNL ? response must be the same 
value as the EQT entry for the system. 

3. DSGEN requests the type of disc storage DISC TYPE? 

Operator responds with 7900, 7901, 2883, or 2883B. A response 

of 2883 implies four subchannels per disc drive; 2883B implies 

two subchannels per disc drive 7900 

4. DSGEN requests the number of tracks (decimal) on the 

system disc SYS DISC SIZE? 

Operator responds with a decimal number less than 

or equal to 200. (A response of 200 leaves three 

tracks as spares. A response less than 200 leaves 

extra tracks as spares.) 200 

5. DSGEN requests the number of drives on the system # DRIVES? 

If response to Step 3 was 2883, the operator responds with 1 or 2; 

if response to Step 3 was 2883B, 7900, or 7901, the operator 

responds with a number between 1 and 4 inclusive 3 

6. DSGEN requests the decimal number of the first track 

on the system disc which is available to DOS-Ill FIRST SYSTEM TRACK? 

Operator responds 

7. DSGEN requests the decimal number of the first sector 

available to DOS-Ill FIRST SYSTEM SECTOR? 

Operator responds. (The system area cannot begin 

before track 0, sector 3) 3 
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8. DSGEN requests the subchannel number of the system disc .... SYS DISC SUBCHNL? 
Operator responds with a number between and 7 

Note: On a 7901 disc, only odd numbered subchannels are available. 



9. DSGEN requests the subchannel number of the user disc. 

(This may be the same as the system disc.) USER DISC SUBCHNL? 

Operator responds with a number between and 7. 

(System efficiency increases if the user disc is on a 

different drive from the system disc.) 2 

10. DSGEN requests the octal channel number (select code) of 

the Time-base Generator TIME BASE GEN CHNL? 

Operator responds with the proper select code or 

if the Time-base Generator is not present 

DSGEN now requests the select code of the privileged- 

interrupt card PRIV INT CARD CHNL? 

Operator responds with the channel (octal) of the privileged 

interrupt fence if privileged interrupt is desired; otherwise, 

type 

11. DSGEN requests the number of DMA channels in the 

system # DMA CHANNELS? 

Operator responds with the number of DMA 

channels available 2 

12. DSGEN requests the last word of available main memory 

in octal LWAMEM? 

Operator responds 27677 

13. DSGEN asks whether SS directives are to be allowed in the 

system ALLOW :SS? 

Operator responds either YES or NO YES 

14. DSGEN requests the type of primary input unit for relocatable 

program modules PRGM INPT? 

Operator responds with PT (for paper tape), TY (for 

teleprinter), DF (for disc file), or MT (for magnetic 

tape; see PREPARE TAPE SYSTEM (02116-91751)) DF 
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15. If the previous answer is DF, DSGEN requests the subchannel 
number of the disc containing the relocatable program 

modules INPUT DISC SUBCHNL? 

Operator responds with the appropriate subchannel 

number. The subchannel must contain a disc (prepared 

by a pre-existing DOS-Ill) whose user area contains only 

relocatable modules of DOS-Ill. By specifying PT to the 

next question (LIBR INPT?) the operator can include 

programs from the paper tape reader in addition to those 

on the disc file 3 

16. DSGEN requests the type of optional input unit for relocatable 

program modules LIBR INPT? 

Operator responds with PT, TY, DF, or MT PT 



Note: Any type of relocatable program can be entered through the Program 
Input Unit or the Library Input Unit. 



17. DSGEN requests the type of input unit for the parameter 

input phase PRAM INPT? 

Operator responds with PT or TY TY 

When DSGEN finishes the initialization phase, the computer halts. 
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Program Input Phase 

During the program input phase, DSGEN accepts relocatable programs from the Program Input 
Unit and Library Input Unit specified during the initialization phase. The operator selects the input 
device by setting switch register bits 0-1 (00 2 for the Program Input Unit, or 10 2 for the Library 
Input Unit), and places the programs in the input device. Main programs must be entered prior to 
their segments. DISCM should be the first module loaded. 

The suggested order of module input is 

DOS-Ill MAIN-MEMORY RESIDENT SYSTEM (DISCM) 
DOS-Ill I/O DRIVERS (DVR05, DVR01, DVR71, . . . ETC) 
DOS-Ill EXEC MODULES ($EX01 . . .) 
EFMP EXEC MODULES (IF DESIRED-$EX30 . . .) 
DOS-Ill JOB PROCESSOR/FILE MANAGER (JOBPR) 
DOS-Ill RELOCATING LOADER (LOADR) 

DOS-Ill ASSEMBLER (MAIN CONTROL, SEGMENTD, SEGMENT1, . . .) 
DOS-Ill FORTRAN (MAIN CONTROL, PASS1, . . .) 

DOS-Ill EFMP UTIL (IF $EX30 . . . AND FORTRAN IV LIBRARY ARE INCLUDED) 
RTE/DOS ALGOL 

RTE/DOS FORTRAN IV LIBRARY OR RTE/DOS BASIC FORMATTER 

RTE/DOS RELOCATABLE PROGRAM LIBRARY (EAU OR FLOATING POINT) -See Note 1 
RTE/DOS FAST FORTRAN PROCESSOR (FFP) SUBROUTINE LIBRARY AND $SETP 
SYSTEM SUBROUTINE - See Note 2 



Any relocatable user programs to be made a permanent part of DOS-Ill 



Notes: 1) For systems based on an HP 21 MX series processor only, the HP 
21MX RTE/DOS DEBUG subroutine should be loaded immedi- 
ately following the Relocatable Program Library (see "Special 
Considerations" under "DEBUG Library Subroutine" in Section 
V). 

2) When the FFP and $SETP tapes are loaded, ERR08 and ERR05 
will occur and messages will be printed on the console because 
the entry point names used by these subroutines replace the 
FORTRAN and library subroutine entry point names. 

Load the first input module and start the computer executing. When entering paper tape, the 
message "*EOT" is output whenever an end-of-tape occurs. The computer halts. Program input can 
be switched back and forth between the input units by varying the switch register bits between 00 2 
and 10 2 before starting the computer. 

To terminate the program input phase, the operator must set switch register bits to 01 2 , and start 
the computer. If there are no undefined externals, this message is printed on the system console: 

NO UNDEFEXTS 

If there are undefined externals, the following message is output: 
UNDEFEXTS 
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The externals are listed one per line and the computer halts. External references are satisfied by 
loading more programs. The operator must set switch register bits to 00 2 (for Program Input Unit) 
or 10 2 (for the Library Input Unit) and start the computer executing. If the externals are to be left 
unsatisfied, set the switch register bits to 01 2 and start the computer executing. 



Note: $EX30 through $EX33 (the EFMP EXEC modules) and $EX36 and 
$EX37 (user EXEC modules) are not listed when missing. 



Parameter Input Phase 

During the parameter input phase, the operator can change selected I/O drivers and EXEC modules 
from disc-memory to main-memory resident or vice versa. In addition, an optional parameter 
allows the operator to change the linking mode for each module. Either current page or base 
page linking can be selected. 

The console driver must always be main-memory resident. Console drivers DVROO and DVR05 
are distributed as main-memory resident while terminal printer driver DVR26 is distributed as 
disc-resident. The console model to be used in the configured system determines which driver 
must be main-memory resident. Any unnecessary I/O drivers must be eliminated at this time. 
If the memory management capability is not desired, delete modules $EX22 and $$MGT from 
the system by specifying them as type 8 (see below). 

DVR31, DISCM, and $EX30 are distributed as main-memory resident modules; they must not 
be changed to disc-resident. 



Each parameter record has the form: 

name,type[,link mode] 
where name is the name of the program to be changed. 

type is the program type code: 

— System main-memory resident 

1 — System disc-resident EXEC modules 

3 — User disc resident main 

4 — Disc resident I/O driver 

5 — User segment 
6,7 — Library 

>7 — Program is deleted from the system 

link mode is the mode of linking to be performed: 
— current page linking (default) 
non-zero — base page linking 

When changing the linking mode, the program type must be specified. An error in either the type 
or link mode parameter results in an error message (ERR10). 
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The following modules are designed to execute with base page linking and must not be changed to 
current page linking mode: 



Program 

HP ALGOL 
HP Assembler 
HP FORTRAN 
HP FORTRAN IV 

HP DOS-Ill Job Processor 



Module Name 

ALGOL 

ASMB 

FTN 

.FTN4 (4K area) 

FTN4 (10K area) 

JOBPR 



For programs changed to current page linking mode, the programs should be structured into sub- 
routines of less than 2048 words (two pages of memory) in length. Current page links are generated 
only at the beginning and end of a program. They cannot be inserted into the program area because 
the boundary between program code and current page links might occur within a skip or jump 
sequence. If a program spans more than two pages, there is no area available for current page links 
in the middle pages, so base page links will be used; thus, the potential for greater efficiency is lost. 

Parameter input is terminated by entering the slash character followed by the letter E (/E). This 
ends the parameter input phase. 

EXEC modules and drivers that are often used may be changed from disc- to main-memory resident. 
The functions of the EXEC modules are 

Module Name Request Codes Function 

Disc work tracks status 

Disc work tracks limits 

Program completion 

Program suspension and associated messages 

Program main or segment search 

(Note: $EX05 calls $EX10) 
User file name search 
Current time processor 
Real-time disc allocation 
:EQ processor 
Load and execute main program or segment 

(Note: see also $EX05) 
System file name search 

(Note: used for file read/write) 
System startup 



$EX01 


16 


$EX02 


17 


$EX03 


6 


$EX04 


7 


$EX05 


8,10 


$EX06 


18 


$EX07 


11 


$EX08 


4(RT) 


$EX09 




$EX10 


8,10 


$EX11 


14,15 


$EX12 
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Module Name 


Request Codes 


$EX13 




$EX14 




$EX15 




$EX16 




$EX17 


23 


$EX18 


1,2,3, 
14,15 


$EX19 




$EX20 




$EX21 


32,33,34 


$EX22 


35,36,38,41 


$EX36 


27 


$EX37 


28 



Function 

Error message processor 

:UP, :DN, :LU processor 

Abort and post-mortem dump 

:G0 parameter processor 

:UD processor 

I/O initiation processor 
(Note: See also $EX11) 

:IN processor 

Disc parity processor 

Programmatic file control 

Memory management 

User written module 

User written module 



Functions of EFMP EXEC Modules 

$EX30 — Always main-memory resident (common routines and values). 

$EX31 DEFINE, CREATE, DESTROY, OPEN, CLOSE 

$EX32 READ, WRITE, RESET, STATUS, CHANGE 

$EX33 - COPY, REPACK 



When changing program types, it is not necessary to explicitly specify all subroutines called by an 
EXEC module which is made main-memory resident. The generator automatically makes the 
proper linkages. In addition to making the subroutine main memory resident, the generator places 
it in the system library, thus making it available to user programs. 
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Disc Loading Phase 

1. DSGEN asks for the number of base page links # LINKS? 

The operator responds with the decimal number of 

links. If the operator responds with a blank character, 

DSGEN allocates the maximum number of links (800) 540 

Loading of the absolute, resident supervisor begins after the establishment of the user and 
system linkage areas. As each program is loaded, DSGEN prints a memory map giving the 
starting and ending locations of both main memory and base page portions of the program. 
In addition, if bit 15 is set (ON), the entry points for main programs and subroutines are 
printed. (Subroutines are indented two spaces, and entry point addresses are preceded by 
an asterisk.) 

2. DSGEN requests memory management subsystem names . . ENTER SUBSYSTEM NAMES 

The operator responds with a series of one line entries which specify the 
subsystem name (1-4 characters) of each subsystem that utilizes memory 
management (see :MMGT directive). Terminate the input list with the 

characters "/E" SUB3 

SUB7 
IE 

Note: Next, DSGEN generates the three I/O tables; equipment table, 

device reference table (logical unit table) and the interrupt table. 

3. DSGEN requests the equipment table entries * EQUIPMENT TABLE ENTRY 

Operator responds with a series of one-line EQT entries, which 

are assigned EQT numbers sequentially from one as they are 

entered. The EQT entry relates the EQT number to an I/O 

channel and driver, in this format nn,DVRnn[,D] [,u] 

where nn is the octal channel number (lower number if multi-board, maximum is 37 8 ) 

DVRnn is the driver name (nn is the equipment type code) 
D, if present, means DMA channel required 

u is the physical subchannel (unit) number (valid responses; 0-31) 

Operator terminates the equipment table entries by typing IE 

Here is a sample Equipment Table: 

* EQUIPMENT TABLE ENTR Y 

10,DVR31,D (EQT entry #1 = disc) 

12,DVR23,D (EQT entry #2 = magnetic tape) 

14,DVR05 (EQT entry #3 = system console) 

15,DVR01 (EQT entry #4 = photoreader) 

16,DVR02 (EQT entry #5 = tape punch) 

1 7,DVR12 (EQT entry #6 = line printer) 

IE (End of table) 
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4. DSGEN requests the logical unit assignments for the device 

reference table * DEVICE REFERENCE TABLE 

For each logical unit number, DSGEN prints n = EQT # ? 

Operator responds with an EQT entry number (m) 

appropriate to the standard definition of n. Numbers 

above 6 may be assigned any EQT entry desired m 

Operator terminates entry by typing IE 

Here is a sample Device Reference Table: 

* DEVICE REFERENCE TABLE 

1 = EQT#? (System console on channel 14, EQT #3) 

3 

2 = EQT#? (Disc on channel 10, EQT #1) 
1 

3 = EQT#? (Disc on channel 10, EQT #1— reserved for system use) 
1 

4 = EQT#? (Standard punch unit on channel 1 6, EQT #5) 
5 

5 = EQT#? (Standard input unit on channel 15, EQT #4) 
4 

6 = EQT#? (Standard list unit on channel 1 7, EQT #6) 
6 

7 = EQT#? (Standard unit definable by user) 
2 

8 = EQT#? (End of table) 
IE 

Note: The number of responses given here determines the number of logical 
units allowed in the system. To allow unassigned logical units for the 
user, respond with a to as many questions as units are desired. 

5. DSGEN requests the interrupt table entries * INTERRUPT TABLE 

Operator responds with an entry for each I/O channel which 

may interrupt, in ascending order and in the format n^option 

where n-^ is the octal channel number (high number if multi-board) between 10 8 and 37 8 
inclusive (must be entered in ascending order) 

option directs the system in handling the interrupt: 

EQT,«2 relates the channel to EQT entry number n^, 

ABS, value places an absolute octal value in the interrupt location, value is an 
octal integer. 

ENT,entry transfers control to the entry point of a user-written system program 
upon interrupt (typically the P.xx entry of a privileged I/O driver). 

If 2883B was specified as the disc type (see "Initialization Phase," step 3) and a second con- 
troller is added, the octal channel number of both controllers must be specified. 

The operator terminates entry by typing /E 
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Here is a sample Interrupt Table: 

INTERRUPT TABLE 

1 0,ENT,P. 73 (Channel 1 linked to privileged interrupt routine P. 73) 

12,EQT,1 (Channel 12 linked to EQT #1) 

13,ABS,102077 (Channel 13 interrupt location filled with an octal halt instruction) 

14,EQT,4 (Channel 14 linked to EQT #4) 

15,EQT,5 (Channel 15 linked to EQT #5) 

16,ABS,0 (Channel 16 interrupt location filled with a NOP; all zeros) 

IE (End of table) 

Note: The EQT numbers need not appear in numerical order. This order is 
determined by referring back to the Equipment Table. The octal 
channel numbers, however, must be in ascending sequence. 

Following the completion of the I/O tables, DSGEN loads the disc-resident executive modules 
(if any), and the disc-resident I/O drivers (if any). 

6. DSGEN reports the last octal address plus 1 of the system 

base page link area LWA LINKS yyyyy 

7. DSGEN requests the first word base page octal address 

of the user link area FWA USER LINKS? 

Operator responds with an octal address greater than 

or equal to yyyyy and less than 2000 8 mmmmm 

8. DSGEN reports the last octal address plus 1 of the main-memory 

resident system LWA PROG xxxxx 

9. DSGEN requests the octal address of the first word of the 

user program area FWA USER ? 

Operator responds with an octal address greater than 

or equal to xxxxx. (This option is provided so that user 

programs can start on a page boundary, if desired) nnnnn 

Note: Some system programs must be base page linked, i.e., the 
FORTRAN compiler. For this reason it is recommended 
that the User Area always be started on a page boundary. 
Since pages contain 2000 a words, the octal number speci- 
fied should be some multiple of 2000 8 . 

DSGEN proceeds to load all user main programs and segments onto the disc with memory 
map listings as described for system programs. 

10. When system generation is complete, DSGEN reports ... * SYSTEM STORED ON DISC 

11. Protect the disc (enable Disc Protect) to prevent access to the system portion of the disc. 

12. The DOS-Ill system which has just been generated (in this case, on Subchannel 0) must be 
loaded into main memory. This is accomplished by using BMDL or the disc loader ROM. (See 
Section XI). 

Note: If a configured DOS-Ill system resides on a disc starting at head 0, track 0, 
simply press RUN. The system will execute and halt with 102071 \ in the 
Memory Data register. Then, set the switch register to the subchannel of the 
newly generated system (in this case, Subchannel 0), press PRESET (INTERNAL 
and EXTERNAL) and press RUN. The newly generated DOS-Ill system will be 
automatically loaded into memory. 
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Sample System Generation 



SYS GEN CODE? 
0103 

SYS DISC CHML? 
15 

DISC TYPE? 
7900 

SYS DISC SIZE? 

200 

# DRIVES? 
2 

FIRST SYSTEM TRACK? 



FIRST SYSTEM SECTOR? 

3 

SYS DISC SUBCHNL? 
3 

USER DISC SUBCHNL? 
3 

TIME BASE GEN CHNL? 
14 

PR IV INT CARD CHNL? 
11 

# DMA CHANNELS? 
2 

LWA MEM? 
77677 

ALLOW :SS? 
YES 

PRGM INPT? 

DF 

INPUT DISC SUBCHNL? 

1 

LI BR INPT? 
PT 
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PRAM INPT? 
TV 



♦ EOT 



NO UNDEF EXTS 



ENTER PROG PARAMETERS 



$EX18,0 
/E 



# LINKS? 

800 



SYSTEM 

NAME PROG BOUNDS BP BOUNDS 



DISCM 






STIME 


05231 


00574 


SSETP 


05362 


00574 


SPFAL 


05403 


00574 



(BOUNDS) 02000 05406 00337 00574 

DVR31 

(BOUNDS) 05406 06127 00574 00635 

F4D.C 

(BOUNDS) 06127 06127 00635 00635 

F2F.B 

(BOUNDS) 06 127 06127 00635 00635 
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DVR00 

(BOUNDS) 06 127 06600 00635 00637 

DVR70 

(BOUNDS) 06600 07022 00637 00642 

SEX18 

(BOUNDS) 07022 077 12 00642 00642 

$$MGT 

(BOUNDS) 077 12 10523 00642 00667 

ENTER SUBSYSTEM NAMES 

/E 

* EQUIPMENT TABLE ENTRY 

10, DVR70 
12, DVR00 



1 3, DVR0 1 
15, DVR31,D 
17,DVR12 
20, DVR1 1,D 
21,DVR23, D 
23, DVR02 
/E 
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* DEVICE REFERENCE TABLE 

1 * EQT #? 
2 

2 = EQT #? 
4 

3 - EQT #? 
4 

4 * EQT #? 
8 

5 » EQT #? 
3 

6 = EQT #? 
5 

7 = EQT #? 
6 

S = EQT #? 
7 

9 = EQT #? 
/E 

* INTERRUPT TABLE 

10,ENT,P.70 
12, EQT, 2 
13, EQT, 3 
16, EQT, 4 
17, EQT, 5 
20, EQT, 6 
22, EQT, 7 
23, EQT, 8 
/E 

EXEC SUPERVISOR MODULES 

NAME PROG BOUNDS BP BOUNDS 

SEX21 

SSRCH 11734 00670 

(BOUNDS) 11034 12375 00667 007 13 
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SEX01 

SADDR 11121 00670 

(BOUNDS) 11034 11136 00667 00670 

SEX02 

SADDR 11124 00670 

(BOUNDS) 11034 11141 00667 00670 

SEX03 

(BOUNDS) 11034 11105 00667 00667 

SEX04 

ASCII 11426 0067 1 

(BOUNDS) 11034 11550 00667 00671 



SEX05 
SSRCH 

(BOUNDS) 



111 17 

11034 11560 



00670 
00667 00670 



SEX06 
SSRCH 
SADDR 

(BOUNDS) 



1 1 136 
1 1577 

11034 11614 



0067 1 
00671 

00667 0067 1 



SEX07 
SADDR 

(BOUNDS) 



11221 00670 

11034 11236 00667 00670 



SEX08 
SADDR 

(BOUNDS) 



1 1207 

11034 11224 



00670 
00667 00670 
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SEX09 

ASCII 11433 00671 

CBOUNDS) 11034 11555 00667 0067 1 

SEX 10 

(BOUNDS) 11034 11372 00667 00667 

SEX1 1 

SSRCH 11057 00670 

CBOUNDS) 11034 11520 00667 00670 

SEX12 

(BOUNDS) 11034 11320 00667 00667 

SEX13 

ASCII 11411 00671 

(BOUNDS) 11034 11533 00667 00671 

SEX14 

ASCII 11557 00670 

(BOUNDS) 11034 11701 00667 0067 1 

SEX15 

ASCII 11403 00670 

(BOUNDS) 11034 11525 00667 0067 1 

SEX 16 

(BOUNDS) 11034 11165 00667 00667 
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SEX 17 

SLBL 114S4 00672 

(BOUNDS) 11034 11532 00667 00674 



SEX19 

SLBL 11427 00674 

(BOUNDS) 11034 11535 00667 00674 



SEX20 

(BOUNDS) 11034 11520 00667 00667 

SEX22 

(BOUNDS) 11034 13134 00667 00705 

I/O DRIVER MODULES 

NAME PROG BOUNDS BP BOUNDS 

DVR01 

(BOUNDS) 13134 13525 00713 007 15 

DVR02 

(BOUNDS) 13134 13361 00713 00715 

DVR11 

(BOUNDS) 13134 14053 007 13 00724 

DVR12 

(BOUNDS) 13134 13521 00713 00715 
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DVR23 

(BOUNDS) 13134 13752 00713 00715 

LWA LINKS 00724 

FWA USER LINKS? 
724 



LWA PR03 14053 

FWA USER? 
16000 



USER SYSTEM PROGRAMS 

NAME PROG BOUNDS BP BOUNDS 

LOADR 

.EAU. 27501 01422 

DUMRX 27 551 01426 

(BOUNDS) 16000 27631 00724 01426 

ASMB 

(BOUNDS) 16000 23131 00724 01303 

ASMBD 

(BOUNDS) 23131 23741 01303 01304 

ASMB1 

(BOUNDS) 23131 24553 01303 01347 

ASMB 2 

(BOUNDS) 23131 24570 01303 01331 
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ASMB3 

(BOUNDS) 23131 24002 01303 01307 

ASMB4 

(BOUNDS) 23131 24040 01303 01311 

ASMB5 

(BOUNDS) 23131 24445 01303 01326 



XREF 






.OPSY 


21230 


01013 


DUMRX 


21270 


01015 



(BOUNDS) 16000 21350 00724 01015 

FTN4 

(BOUNDS) 16000 31170 00724 01272 

F4.0 

(BOUNDS) 31170 37041 01272 01354 

F4. 1 

(BOUNDS) 31170 34732 01272 01406 

F4.2 

(BOUNDS) 31170 36260 01272 01370 
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XDISC 

. S¥CH 20620 1041 

FMTIO 20637 01041 

INDEX 22070 01101 

.PRAM 22246 01101 

EXECX 22356 01101 

INITX 22402 01101 

FLIB 22441 01101 

.FLUN 22544 01107 

.XFER 22565 01107 

DBLE 22631 01110 

SNGL 22666 01112 

FRMTR 22734 01113 

.OPSY 25474 1360 

.EAU. 25534 01360 

DUMRX 25604 01361 

.ZRLB 25664 01361 

.XPAK 25725 1361 

.ENTR 26122 01373 

.PACK 26212 01374 

.XCOM 26326 01374 

(BOUNDS) 16000 26377 00724 01374 



JOBPR 

(BOUNDS) 16000 30422 00724 01401 



♦SYSTEM STORED ON DISC 
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DSGEN DISC CARTRIDGE SYSTEM GENERATION 



Each HP 24307B DOS-Ill Disc Operating System with an HP 7900 Disc device included in the sys- 
tem hardware is delivered with a disc cartridge labeled DSGEN (HP part number 24307-13001). The 
DSGEN cartridge contains a DOS-Ill software system together with a set of modules with which to 
generate a DOS-Ill software system in the computer's memory. 

Care must be taken to protect the contents of this disc from modification or destruction. The 
DSGEN cartridge can be copied to another disc and set aside. Modification can now be made to 
the copy without affecting the original disc. 

If modules not included on the DSGEN cartridge are required, they must be loaded into the system 
from another type of input unit during the system generation procedure. 

The I/O PCA boards must be arranged according to the select codes specified by the label on the 
DSGEN cartridge. For example: 

Select Codes 



11 7900 DISC 

10 SYSTEM CONSOLE 

The example indicates that the HP 7900 disc device resides in select codes 11 and 12, and the system 
console device resides in select code 10. 

Initial generation steps differ for an HP 21MX computer (with an optional disc loader ROM in- 
stalled) and an HP 2100A/S computer. For an HP 21MX not equipped with a disc loader ROM, 
use HP 2100A/S procedures. 

HP 21MX 

1. Insert the DSGEN cartridge _in the HP 7900 disc device. Press PRESET. 

2. Select the S-register for display. Press CLEAR DISPLAY. 

3. Set the select code of the disc in bits 11 through 6. Set bit 14 to select the disc loader ROM 
to be loaded. 

4. Press STORE to store the contents of the Display Register in the S-register. Press IBL to load 
the contents of the disc loader ROM into the uppermost 64 locations of memory. 

The computer halts with octal 102077 in the T-register. Press RUN and dialogue with the system 
begins. Go to step 5. 

HP 2100A/S 

1. Load and configure the Stand-alone Paper Tape Bootstrap Loader to the system hardware. 

2. Insert the DSGEN cartridge in the HP 7900 Disc device. 

3. Load DOS-Ill from Subchannel 1 and initiate it using the Stand-alone Paper Tape Bootstrap 
Loader. Go to step 5. 

Once DOS-Ill is initiated, a dialogue between the system and the operator begins on the system con- 
sole. In the following example, information typed by the operator is underlined, and the informa- 
tion printed by the system is not underlined. These underlines will not appear on the terminal 
under actual operating conditions. 



10-28 



5. The DOS-Ill system begins the dialog by requesting the DATE directive : 
INPUT :DATE,XXXXXXXXXX 



@:DATE„ 

SUBCHAN=1 

LBL=DSGEN 

@ 

:JOB 

JOB 

@ 

:UD,*,0 

@ 

:IN,* 

@ 

:UD,DSGEN,1 

@ 

:UD 

SUBCHAN=1 

LBL=DSGEN 

@ 

:DD 

@ 

:UD,*,0 



DATE directive entered 



JOB directive entered 



Change user disc to Subchannel 0, no label 
Initialize user disc, no label 

Change user disc to Subchannel 1, label is DSGEN 
Verify correct subchannel and label 

Disc-to-disc dump of disc on Subchannel 1 
Destination disc for dump operation. 



6. Wait for the system to respond with @ to indicate that the entire contents of Subchannel 1 
have been copied to Subchannel 0. 

7. Press HALT. 

8. Remove the DSGEN cartridge from the HP 7900 Disc device. 

9. Insert a disc cartridge to be used for subsequent DOS-Ill system generation. 

10. Load DOS-IH from Subchannel and initiate it using the Stand-alone Paper Tape Bootstrap 
Loader. 

11. System dialog begins: 

INPUT :DATE,XXXXXXXXXX 



@ :DATE„ 

SUBCHAN=0 

LBL=DSGEN 

@ 

:JOB 

JOB 

@ 

:LIST,S,1,INDEX 



DATE directive entered 



JOB directive entered 



List user source file, INDEX on the console (the 
following list is an example) 
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0001 


DOS III B (24307B) 


REV 1419 


0002 


THIS INDEX RELATES ' 


rHE NAMES OF THE RELOCATABLE MODULES 


0003 


TO THE 


PART NUMBERS 


OF THE 


EQUIVALENT PAPER TAPES AND 


0004 


INDICATES THE PURPOSE OF THE MODULES IN THE SYSTEM. 


0005 


NAME 


PART NUMBER 


REV 


DESCRIPTION 


0006 


DISCM 


24307-16002 


1419 


DISC MONITOR 


0007 


$EXMD 


24307-16003 


1419 


EXEC MODULES 


0008 


DVR00 


20985-60001 


1419 


TTY-LIKE CONSOLE/TERMINAL 


0009 


DVR01 


20987-60001 


1419 


PAPER TAPE READER 


0010 


DVR02 


20989-60001 


1419 


PAPER TAPE PUNCH 


0011 


DVR05 


24157-60001 


1419 


TTY-LIKE CONSOLE 


0012 


D2892 


24272-60001 


1419 


2892B CARD READER (DVR11) 


0013 


D2 767 


24168-60001 


1419 


2767A LINE PRINTER (DVR12) 


0014 


D2610 


24271-60001 


1419 


2610A/2614A LINE PRINTER (DVR12) 


0015 


D2607 


24349-60001 


1419 


2607A LINE PRINTER (DVR12) 


0016 


DVR23 


13024-60001 


1419 


7970B/E MAG TAPE 


0017 


DVR26 


24333-60001 


1419 


2762A CONSOLE PRINTER 


0018 


DVR31 


24156-60001 


1419 


7900/7901/2870 DISC 


0019 


DVR67 


24341-16001 


1419 


12889A HS SERIAL IF 


0020 


DVR72 


24350-16001 


1419 


12587B ASYNC DATA SET IF 


0021 


DVR73 


24377-16001 


1419 


12920A/B MUX 


0022 


EFMP 


24309-60002 


1419 


EXT FILE MGR EXEC MODULES 


0023 




24309-60003 


1419 


EXT FILE MGR UTILITIES 


0024 


JOBPR 


24307-16004 


1419 


JOB PROCESSOR 


0025 


RLODR 


24308-60001 


1419 


RELOCATING-LINKING LOADER 


0026 


ASMB 


24158-60001 


B 


ASSEMBLER 


0027 




24158-60002 


B 




0028 




24158-60003 


B 




0029 




24158-60004 


B 




0030 




24158-60005 


B 




0031 




24158-60006 


B 




0032 




24158-60007 


B 




0033 


.FTN4 


24170-60001 


C 


FORTRAN IV COMPILER 


0034 




24170-60002 


C 




0035 




24170-60003 


C 




0036 


FTN4 


24177-60001 


B 


FORTRAN IV COMPILER (10K AREA) 


0037 




24177-60002 


B 




0038 


ALGOL 


24129-60001 


C 


ALGOL COMPILER 


0039 




24129-60002 


C 




0040 


XREF 


24223-60001 


B 


CROSS REF TABLE GENERATOR 


0041 


F2E.N 


24151-60001 


D 


RELO SUBR (EAU) LIBR 


0042 


F2F.N 


24248-60001 


B 


RELO SUBR (FP ) LIBR 


0043 


F4D.N 


24152-60001 


C 


RELO SUBR (FTN4) LIBR 


0044 


FFP.N 


12907-16001 


A 


RELO SUBR (FFP) LIBR 


0045 


ATD01 


24381-16001 


1419 


ASYNC TERMINAL DRIVER #1 


0046 


DVR33 


24278-60001 


1419 


12908 WCS DRIVER 


0047 


MASMB 


24332-60001 


1419 


12908" WCS MICRO ASSEMBLER 


0048 


WCSUT 


24333-60001 


A 


12908 WCS I/O UTILITIES 


0049 


MDBUG 


24334-60001 


1419 


12908 WCS DEBUG EDITOR 


**** j 


.1ST END **** 
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At this point, use the list printed to select those modules which are to be included in the system to 
be generated. The PURGE directive is used to flag modules and drivers for deletion. Some guide- 
lines for building a DOS-Ill system follow. 

a. These modules must be included in every system: 



DISCM 

$EXMD 

DVR01 

DVROO] 

DVR05 1 

DVR26 j 

DVR31 

JOBPR 

EFMP 

F2E.N 

F2F.N 



Disc Monitor 

EXEC Modules 

Paper Tape Reader Driver 

Choose One, System Console Driver 

Disc Device Driver 

Job Processor 

Include if EFMP or IMAGE is desired 

( EAU 
Choose One, I _. , . . , . ... 

Floating-point Arithmetic 



These driver modules are required if the associated peripheral device is included in the system 
to be generated: 

D2767 | [ DVR12 - HP 2767 Line Printer Driver 

D2610 [ Choose One, j DVR12 - HP 2610/2614 Line Printer Driver 

D2607 j I DVR12 - HP 2607 Line Printer Driver 

DVR23 HP 7970A/B/E Magnetic Tape Driver 

DVR02 HP 2895/2753 Paper Tape Punch Driver 

D2892 DVR11 - HP 2892 Card Reader Driver 

DVR67 HP 12889A Interface Driver 

DVR72 HP 12587B Interface Driver 

DVR73 HP 12920A/B MUX Driver 

DVR33 HP 12908A WCS Driver 



c. These modules are normally included during system generation, but may be run from the user 
area instead: 



RLODR 

ASMB 

ALGOL 

FTN4 

F4D.N 



FFP.N 
XREF 



Relocating/Linking Loader 

Assembler 

ALGOL Compiler 

FORTRAN IV Compiler 

FORTRAN IV Library — Required in addition to the 
library selected under point a above if FORTRAN IV 
or EFMP is included in the system to be generated. 

FFP Library — Required if the FFP option is present 
(this module must appear in the directory after F4D.N). 

Cross Reference Table Generator 



d. These modules should be included if WCS is present: 



MASMB 
WCSUT 



HP 12908 WCS Micro-assembler 
HP 12908 WCS I/O Utilities 
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e. These modules must be deleted from the cartridge on Subchannel under specific conditions: 

FFP.N If FFP hardware is not present 

F2F.N If Floating Point hardware is not present 

RDBUG If HP 21MX is present 

Any drivers not required by the system to be generated. 

f. This module must be deleted from the cartridge on Subchannel 0: 

INDEX 
MDBUG 

In the dialog following, assume that a DOS-Ill system is to be generated which includes these 
modules: 

DISCM 

$EXMD 

DVR01 

DVR02 

DVR03 

D2767 

DVR23 

DVR31 

JOBPR 

RLODR 

ASMB 

FTN4 

XREF 

F2F.N 

F4D.N 

The dialog continues from the @ symbol at the end of Step 11: 

:PURGE,EFMP,DVR00,DVR26 > F2E.N,D2892,D2610,D2607 

EFMP 

DVR00 

DVR26 

F2E.N 

D2892 

D2610 

D2607 

@ 
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:PURGE,DVR67,DVR72,DVR73,ALGOL,FFP.N,ATD01,DVR33 

DVR67 

DVR72 

DVR73 

ALGOL 

FFP.N 

ATD01 

DVR33 

@ 

:PURGE,.FTN4,MASMB,WCSUT,MDBUG 

.FTN4 

MASMB 

WCSUT 

MDBUG 

@ 

:PURGE,INDEX 

INDEX 



:LIST,U,1 

NAME TYPE 
SUBCHAN=0 
DISCM RB 
$EXMD RB 
DVR01 RB 
DVR02 RB 
DVR05 RB 
D2767 RB 
DVR23 RB 
DVR31 RB 
JOBPR RB 
RLODR RB 
ASMB RB 
FTN4 
XREF 
F2F.N 
F4D.N RB 
@ 

:EJOB 
END JOB 
@ 



List the user directory on the console 
SCTRS DISC ORG PROG LIMITS B.P. LIMITS 



ENTRY FWAM PB 



RB 
RB 
RB 



(2)0026 
0)31)38 
00004 
00003 
00003 
00004 
00006 
00005 
00081 
00059 
00088 
00177 
00023 
00113 
00148 



T007 000 
T007 026 
T009 043 
T009 047 
T010 002 
T010 011 
T010 027 
T010 037 
T015 000 
T016 033 
T017 044 
T024 028 
T030 006 
T033 004 
T035 021 



Terminate current job 



The modules residing on Subchannel are ready to be used for DOS-Ill system generation. Proceed 
as follows: 

1. Load the DSGEN program from paper tape using the Stand-alone Paper Tape Bootstrap 
Loader or the paper tape loader ROM. 

2. If the DSGEN program loaded is not configured, perform the procedure under "DSGEN 
Configuration" presented earlier in this section. 
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3. Use DSGEN to format the disc cartridge on Subchannel 1. When this step is completed, the 
computer will halt with 102077 8 in the Memory Data register. 

4. Use DSGEN to generate a DOS-Ill system on Subchannel 1. Proceed as directed under "Using 
DSGEN to Generate DOS-Ill" in this section. 

After DOS-Ill system generation is completed, modules to be run from the user area of disc memory 
can be retrieved from the master DSGEN cartridge. For example, if WCS is present in the system, 
the modules WDBUG and ATD01 may be loaded into the user area as follows: 

1. Insert the master DSGEN disc cartridge in the HP 7900 Disc device. 

2. Load DOS-Ill from Subchannel and initiate it using the Stand-alone Paper Tape Bootstrap 
Loader or the disc loader ROM. 

3. System dialog begins: 

INPUT :DATE,XXXXXXXXXX 

@ :DATE„ DATE directive entered 

SUBCHAN=0 

LBL=DSGEN 

@ 

:UD,DSGEN,1 Change user disc to Subchannel 1, label is DSGEN 

@ 

: DD,U,MDBUG, ATD01 Disc-to-disc dump of specified files from user area 

@ 

:UD,*,0 Destination disc for dump operation 

@ 

:LIST,U,1 List user directory to verify that modules were copied 

4. The system will print a list of the user directory on the console. 
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Sample DSGEN Cartridge Preparation and System Generation 



INPUT :DATE,XXXXXXXXXX 

@ '.DA j t 
SUBCHAN=1 

LBL=DSGEN 



: JOB 

JOB j 

@ 

:UD,*,0 

LBL=SY5TEM 

DISC GEN CODE 6500 NOT SYS GEN CODE 0529 ERR POSS 

RE-ENTER STATEMENT ON TTY. 

@ 

:UD, SYSTEM, 

DISC GEN CODE 6500 NOT SYS GEN CODE 0529 cRR POSS 

@ 

: IN,* 

DOS LABEL SYSTEM 

OK TO PURGE? 

YES 

@ 

:UD, DSGEN, 1 

@ 

:UD 

SUBCHAN=1 

LBL=DSGEN 

@ 

:DD 

@ 

:UD, *,0 

@ 

I NPUT : DATE, XXXXXXXXXX 

S :DATE,, 

SUBCHAN=0 

LBL=DSGEN 

@ 

: JOB 

JOB 
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LIST..S., 1; INDEX 



0001 

0002 

0003 

0004 

0005 

0006 

0007 

0008 

0009 

0010 

001 1 

0012 

0013 

0014 

0015 

0016 

0017 

0018 

0019 

0020 

0021 

0022 

0023 

0024 

0025 

0026 

0027 

0028 

0029 

0030 

0031 

0032 

0033 

0034 

0035 

0036 

0037 

0038 

0039 

0040 

0041 

0042 

0043 

0044 

0045 

0046 

0047 

0048 

0049 
**** 



DOS III B (24307B) 
THIS INDEX RELATES 
TO THE PART NUMBERS 
INDICATES THE PURPO 



REV 1419 
THE NAMES OF THE RELOCATABLE MODULES 

OF THE EQUIVALENT PAPER TAPES AND 
SE OF THE MODULES IN THE SYSTEM. 



NAME 

DISCM 

SEXMD 

DVR00 

DVR01 

DVR02 

DVR05 

D2892 

D2767 

D2610 

D2607 

DVR23 

DVR26 

DVR31 

DVR67 

DVR72 

DVR7 3 

EFMP 

JOBPR 
RLODR 
ASMB 



.FTN4 



FTN4 

ALGOL 

XREF 

F2E.N 

F2F.N 

F4D.N 

FFP.N 

ATD01 

DVR33 

MASMB 

WCSUT 

MDBUG 



PART NUMBER 

24307-16002 

24307-16003 

20985-60001 

20987-60001 

20989-60001 

24157-60001 

24272-60001 

24168-60001 

24271-60001 

24349-60001 

13024-60001 

24333-60001 

24156-60001 

24341-16001 

24350-16001 

24377-16001 

24309-60002 

24309-60003 

24307-16004 

24308-60001 

24158-60001 

24158-60002 

24158-60003 

24158-60004 

24158-60005 

24158-60006 

24158-60007 

24170-60001 

24170-60002 

24170-60003 

24177-60001 

24177-60002 

24129-60001 

24129-60002 

24223-60001 

24151-60001 

24248-60001 

24152-60001 

12907-16001 

24381-16001 

24278-60001 

24332-60001 

24333-60001 

24334-60001 



REV 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

1419 

B 

B 

B 

B 

B 

B 

B 

C 

C 

c 

B 
B 
C 

c 

B 

D 

B 

C 

A 

1419 

1419 

1419 

A 

1419 



DESCRIPTION 

DISC MONITOR. 

EXEC MODULES 

TTY-LIKE CONSOLE/TERMINAL 

PAPER TAPE READER 

PAPER TAPE PUNCH 

TTY-LIKE CONSOLE 

2892B CARD READER (DVR11) 

2767A LINE PRINTER (DVR12) 

2610A/2614A LINE PRINTER (DVR12) 

2607A LINE PRINTER (DVR12) 

7970B/E MAG TAPE 

2762A CONSOLE PRINTER 

7900/7901/2870 DISC 

12889A HS SERIAL IF 

12587B ASYNC DATA SET IF 

12920A/B MUX 

EXT FILE MGR EXEC MODULES 

EXT FILE MGR UTILITIES 

JOB PROCESSOR 

RELOCATING-LINKING LOADER 

ASSEMBLER 



FORTRAN IV COMPILER 



FORTRAN IV COMPILER ( 1 0K AREA) 



ALGOL COMPILER 



CROSS REF 
RELO SUBR 
RELO SUBR 
RELO SUBR 
RELO SUBR 



TABLE GENERATOR 
<EAU) LIBR 
(FP ) LIBR 
(FTN4) LIBR 
(FFP) LIBR 

#1 



ASYNC TERMINAL DRIVER 
12908 WCS DRIVER 
12908 WCS MICRO ASSEMBLER 
12908 WCS I/O UTILITIES 
12908 WCS DEBUG EDITOR 



LIST END ***♦ 
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:PU.»DVR00.»DVR26.,F2F.N,EFMP,D2 76 7,D2610,D2 892,uVR6 7,DVR73..^VR72 

DVR00 

DVR26 

F2F.N 

EFMP 

D2767 

D2610 

D2892 

DVR6 7 

DVR73 

DVR72 

@ 

:PU..DVR33, • FTN4, ALGOL, FFP.N,ATD0 1 , MAS MB, fcCSUT, MDBUG 

DVR33 

.FTN4 

ALGOL 

FFP.N 

ATD01 

MAS MB 

VCSUT 

MDBUG 

@ 

:PU, INDEX 

INDEX 

@ 

:LIST,U* 1 



NAME TYPE 
SUBCHAN=0 

DISCM RB 

SEXMD RB 

DVR01 RB 

DVR02 RB 

DVR05 RB 

D2607 RB 

DVR23 RB 

DVR31 RB 

JOBPR RB 

RLODR RB 

ASMB RB 

FTN4 RB 

XREF RB 

F2E.N RB 

F4D.N RB 
@ 

:EJOB 
END JOB 
§ 



SCTRS DISC ORG 



PROG LIMITS 



3. P. LIMITS 



ENTRY FViAM 



Pa 



00026 
00108 
00004 
00003 
00003 
00006 
001306 
00005 
00081 
00059 
00088 
00177 
00023 
001 19 
00148 



T007 
T007 
T009 
T009 
T010 
T010 
T010 
T010 
T015 
T016 
T017 
T024 
T030 
T030 
T035 



000 
026 
043 
047 
002 
021 
027 
037 
000 
033 
044 
028 
006 
029 
02 1 
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Preparation of the DSGEN cartridge is completed. Proceed as directed under "Using DSGEN to 
Generate DOS-Ill" in this section. Sample generation dialog follows: 



SYS GEN CODE? 
4000 

SYS DISC CHNL? 
1 1 

DISC TYPE? 
7900 

SYS DISC SIZE? 
200 

# DRIVES? 

1 

FIRST SYSTEM TRACK? 



FIRST SYSTEM SECTOR? 

3 

SYS DISC SUBCHNL? 
1 

USER DISC SUBCKNL? 

1 

TIME BASE GEN CHNL? 
1 7 

PRIV INT CARD CHNL? 



# DMA CHANNELS? 
2 
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LWA MEM? 
37677 

ALLOW :SS? 
YES 

PRGM INPT? 

DF 

INPUT DISC SUBCHNL? 



LIBR INPT? 
PT 

PRAM INPT? 
TY 



*EOT 



NO UNDEF EXTS 



ENTER PROG PARAMETERS 



SEX18^0 






/E 






# LINKS? 






800 






SYSTEM 






NAME 


PROG BOUNDS 


BP BOUNDS 


DISCM 






STIME 


05274 


00603 


SSETP 


05421 


00603 


SPFAL 


05442 


00603 


(BOUNDS) 


02000 05445 


00337 00603 


SEX18 






(BOUNDS) 


05445 06341 


00603 00631 
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$$MGT 

(BOUNDS) 06341 07152 00631 00647 

DVR05 

(BOUNDS) 07152 07421 00647 00651 

DVR31 

(BOUNDS) 07421 10145 00651 00713 

F2E.D 

(BOUNDS) 10145 10145 00713 00713 

F4D.C 

(BOUNDS) 10145 10145 00713 00713 

ENTER SUBSYSTEM NAMES 

/E 

* EQUIPMENT TABLE ENTRY 

10,DVR00 

ERR 25 

10,DVR05 

1 1 * DVR3 1 j D 

13..DVR01 

14,DVR02 

15.,DVR23,D,0 

15,DVR23,D, 1 

20,DVR12 

/E 
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* DEVICE REFERENCE TABLE 

1 = EQT #? 
1 

2 = EQT #? 
2 

3 = EQT #? 
2 

4 = EQT #? 

5 = EQT #? 
3 

6 = EQT #? 
7 

7 = EQT #? 


8 = EQT #? 
5 

9 = EQT #? 
6 

10 = EQT #? 
/E 

* INTERRUPT TABLE 

10, EQT, 1 
12., EQT., 2 
13.. EQT .,3 
14, EQT, A 
16, EQT, 5 
20, EQT, 7 
/E 

EXEC SUPERVISOR MODULES 

NAME PROG BOUNDS BP BOUNDS 

SEX01 

SADDR 10520 00714 

(BOUNDS) 10433 10535 00713 00714 



SEX02 

SADDR 10523 00714 

(BOUNDS) 10433 10540 00713 00714 
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SEX03 

(BOUNDS) 10433 10504 00713 00713 



SEX04 

ASCII 11025 00715 

(BOUNDS) 10433 11147 00713 00715 



SEX05 

SSRCH 10516 00714 

(BOUNDS) 10433 11157 00713 00714 



SEX06 

SSRCH 10535 00715 

SADDR 11176 00715 

(BOUNDS) 10433 11213 00713 00715 



SEX07 

SADDR 10620 00714 

(BOUNDS) 10433 10635 00713 00714 



SEX08 

SADDR 10606 00714 

(BOUNDS) 10433 10623 00713 00714 



SEX09 

ASCII 11032 00715 

(BOUNDS) 10433 11154 00713 00715 



SEX10 

(BOUNDS) 10433 10771 00713 00713 
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$EX1 1 

SSRCH 10456 00714 

(BOUNDS) 10433 11117 00713 00714 



SEX12 

(BOUNDS) 10433 10717 00713 00713 



SEX13 

ASCII 11010 00715 

(BOUNDS) 10433 11132 00713 00715 



SEX14 

ASCII 11156 00714 

(BOUNDS) 10433 11300 00713 00715 



SEX15 

ASCII 11002 00714 

(BOUNDS) 10433 11124 00713 00715 



SEX16 

(BOUNDS) 10433 10564 00713 00713 



SEX17 

SLBL 11023 00716 

(BOUNDS) 10433 11131 00713 00720 



SEX19 

SLBL 11026 00720 

(BOUNDS) 10433 11134 00713 00720 



SEX20 

(BOUNDS) 10433 11117 00713 00713 
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SEX21 

SSRCH 11472 00714 

(BOUNDS) 10433 12133 00713 00742 



SEX22 

(BOUNDS) 10433 12603 00713 00727 

I/O DRIVER MODULES 

NAME PROG BOUNDS BP BOUNDS 

DVR01 

(BOUNDS) 12603 13174 00742 00744 

DVR02 

(BOUNDS) 12603 13030 00742 00744 

DVR12 

(BOUNDS) 12603 13374 00742 00744 

DVR23 

(BOUNDS) 12603 13422 00742 00744 

LWA LINKS 00744 

FWA USER LINKS? 
744 

LWA PROG 13422 

FVA USER? 
14000 
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USER SYSTEM PROGRAMS 

NAME PROG BOUNDS BP BOUNDS 

JOBPR 

(BOUNDS) 14000 26613 00744 01412 



.EAU. 


2551 1 


01446 


DUMRX 


25561 


01452 



(BOUNDS) 14000 25641 00744 01452 

ASMB 

(BOUNDS) 14000 21131 00744 01323 

ASMBD 

(BOUNDS) 21131 21741 01323 01324 

ASMB1 

(BOUNDS) 21131 22553 01323 01367 

ASMB2 

(BOUNDS) 21131 22570 01323 01351 

ASMB3 

(BOUNDS) 21131 22002 01323 01327 

ASMB4 

(BOUNDS) 21131 22040 01323 01331 

ASMB5 

(BOUNDS) 21131 22445 01323 01346 
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FTN4 

(BOUNDS) 14000 27170 00744 01312 

F4.0 

(BOUNDS) 27170 35041 01312 01374 

F4. 1 

(BOUNDS) 27170 32732 01312 01426 

F4.2 

(BOUNDS) 27170 34260 01312 01410 



XREF 






.OPSY 


17241 


01033 


DUMRX 


17301 


01035 



(BOUNDS) 14000 17361 00744 01035 



♦SYSTEM STORED ON DISC 
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SECTION XI 
Loading DOS-Ill 



This section describes the loaders used to load a generated DOS-Ill system into main memory. 

Loaders for an HP 21MX computer and an HP 2100A/S computer are essentially the same — the 
only apparent difference being how the loaders are supplied. 

HP 21MX LOADERS 

The HP 21MX processor is equipped with a paper tape loader ROM. The contents of this ROM 
are equivalent to the Basic Binary Loader portion of the BMDL used with HP 2100A/S compu- 
ters. The ROM contents must be placed in memory before programs can be loaded from paper 
tape. 

The HP 21MX processor can also be equipped with an optional disc loader ROM. This ROM 
performs the same functions as the BMDL used with HP 2100A/S computers. (If your HP 21MX 
does not have the disc loader ROM installed, follow steps for loading programs from disc using 
HP 2100A/S loaders.) The ROM contents must be placed in memory before programs can be 
loaded from a disc. 

To load either of the ROM's into memory, perform the following at the operator panel: 

a. Press PRESET. 

b. Select the S-register for display in the Display Register. 

c. Press CLEAR DISPLAY to clear the contents of the Display Register. 

d. Bits 15 and 14 of the Display Register are used to select the loader ROM to be loaded. The 
paper tape loader ROM is automatically selected by the clear display operation. Set bit 14 
to select the disc loader ROM. 

e. Change bits 11 through 6 of the Display Register to the octal select code of the disc or 
paper tape reader. 

f. Change bits 5 through of the Display Register to contain the system disc subchannel 
number. 
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g. Press STORE to store the contents of the Display Register in the S-register. 

h. Press IBL to load the contents of the selected loader ROM into the uppermost 64 locations 
in the first 32K of directly addressable memory. Press RUN. 

The computer halts with octal 102077 in the T-register (indicating a successful load of the 
ROM). 

i. Place the tape or disc (containing the program to be loaded) into the input device and 
ready that device. Press RUN. 

HP 2100A/S LOADERS 

To load a generated DOS-Ill system from the disc into main memory of an HP 2100A/S com- 
puter, execute either the BMDL or the Stand-alone Bootstrap Loader. The former resides in the 
uppermost 64 words of main memory and is hardware protected. The BMDL exists in two ver- 
sions depending on the type of disc drive included in the system (HP 7900/7901, HP 2883/2884). 
Operation of these loaders is essentially the same. They consist of two parts: a Basic Binary 
Loader which loads absolute binary programs into main memory (from paper tape devices), and 
a disc loader which loads the configured DOS-Ill system from the disc into main memory. 

The BMDL loads the system from any active subchannel, with one major requirement: whether 
that particular system is loaded or not, a configured DOS-Ill system must exist on the disc start- 
ing at head 0, drive of the disc device. Head 0, drive corresponds to Subchannel on the 
HP 2883/2884 disc, or to Subchannel 1 on the HP 7900/7901 disc. The BMDL will read that 
system or any other configured DOS-Ill system on the disc as long as a configured system resides 
on head 0, drive 0. 

To load a configured DOS-Ill system when no system exists on head 0, drive 0, the user must 
load the Stand-alone Bootstrap Loader into main memory (using the paper tape portion of the 
BMDL) and execute the Stand-alone Bootstrap Loader. This program loads the configured 
DOS-HI system from the specified disc subchannel without the existence of a configured system 
on head 0, drive of the disc. 
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USING THE BMDL TO LOAD 
ABSOLUTE BINARY PROGRAMS 

The BMDL loads absolute binary program tapes into main memory of an HP 2100A/S computer. 
The Loader resides in the last 64 10 words of main memory. 

Note: When using an HP 21MX computer, the paper tape loader ROM is used to 
load absolute binary program tapes into memory. Replace steps 2 through 
6 (below) with the procedure (described earlier) for loading a paper tape ROM. 

Operating Instructions 

1. Halt the computer. 

2. Place the tape to be loaded into the paper tape input device and ready that device. 

3. Set the Loader starting address according to the memory size of the computer: 

Memory Size Starting Address (octal) 

16K 037700 

24K 057700 

32K 077700 

4. Clear the switch register. 

5. Enable the Loader 

6. Press both PRESET buttons. 

7. Press RUN. 

8. After all or part of the tape is read, the computer halts with 1020xx 8 displayed. 

If xx = 11, a checksum error was detected. Check for torn tape or dust in the reader, check the 
tape for ragged edges or torn holes, then return to step 2. 

If xx = 55, an address error was detected. A program being loaded attempted to enter a location 
reserved for the main-memory resident Loader, or a location not available in the com- 
puter. Check that an absolute binary tape was used, and that it was placed properly 
in the reader. 

If xx = 77, the tape was loaded correctly. 
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INITIATING DOS-Ill WITH THE BMDL 



When DOS-Ill has been generated on the disc (by DSGEN), it can be loaded into main memory and 
initiated by a main-memory resident program called the BMDL. This program resides permanently 
in the last 64 10 words of main memory and is hardware protected. Once DOS-Ill has been loaded 
and initiated, it is ready to process user tasks. 

Note: When using an HP 21MX computer with a disc loader ROM installed, steps 1 

through 6 (below) are replaced by the ROM loading procedures described earlier. 



Operating Instructions 

1. Verify that a configured DOS-HI system resides on head 0, drive of the disc. (Head 0, drive 
corresponds to subchannel 1 for the HP 7900/7901, or to subchannel for the HP 2883/2884 
disc.) If a configured system does not reside there, then use the Stand-alone Bootstrap Loader 
program (see Initiating DOS-HI with the Stand-alone Bootstrap Loader, in this Section). 

2. Set a starting address of 0x7750, where x = 3 f or 16K; x = 5 f or 24K; x = 7 for 32K. 

3. Enable (unprotect) the main-memory resident Loader. 

4. Press PRESET button(s) and start the computer executing. 

5. The computer halts with 102077 8 displayed in the Display register. Protect the main- 
memory resident Loader (if necessary). 

6. Set the disc subchannel number of the system to be loaded into the switch register (bits 5 
through 0). 

7. Start computer execution. The system is loaded into main memory and prints the following 
message: 

INPUT .DATE, XXXXXXXXXX (No Time-base Generator) 

or 
INPUT .DATE, XXXXXXXXXX,H,M (Time-base Generator) 

8. All other directives are ignored until a valid DATE directive is entered. Immediately following 
the DATE directive, the only valid directives are :TRACKS, :BATCH, :TYPE, and :JOB. 

All other directives are ignored until a JOB directive is entered. 

11-4 



CONFIGURING THE DOS-Ill STAND-ALONE 
BOOTSTRAP LOADER 



Once DOS-IH has been generated onto a disc, it may be initiated into operating status using the 
DOS-Ill Stand-alone Bootstrap. The Bootstrap, however, must be configured before being used. 



Operating Instructions 

1. Turn on all equipment. 

2. Load (using the BMDL or the paper tape loader ROM) and configure the SIO Punch or Tele- 
printer Driver. 

3. Load the Bootstrap using the BMDL or the paper tape loader ROM. 

4. Set up the Bootstrap configuration starting address at location 2 8 . 

5. Set switch register bits 5 through equal to the octal channel number (select code) of the 
disc controller (low number, high priority channel). 

6. Set switch register bit 15 on to punch a configured Bootstrap tape; off to configure the 
Bootstrap in main memory only. 

7. Start the computer executing. 

8. If bit 15 of the switch register is set, the Bootstrap punches out a configured copy of itself 
and halts. For another copy, simply start the computer executing again. 



11-5 



INITIATING DOS-Ill WITH THE STAND-ALONE 

BOOTSTRAP LOADER 



When DOS-Ill has been generated onto the disc, it can be loaded into main memory and initiated 
by using a small stand-alone program called the Stand-alone Bootstrap Loader. Once DOS-Ill has 
been loaded and initiated, it is ready to process user tasks. 



Note: The Stand-alone Bootstrap Loader need be used only if a configured 
DOS-Ill system does not reside on head 0, drive of the disc. If a 
system resides on the disc in the above mentioned area, the BMDL 
can be used. 



Operating Instructions 

1. Turn on all equipment. 

2. Configure a Stand-alone Bootstrap Loader (as previously described). 

3. Load the configured Bootstrap into main memory using the BMDL or the paper tape loader 
ROM. 

4. Set up the starting address of the Bootstrap at location 100 8 . 

5. Set switch register bits 5 through equal to the octal subchannel of the system disc. (If this 
subchannel differs from that established at system generation time, the new subchannel 
overrides the old.) 

6. Set switch register bit 14 equal to one if the disc type is 2883 with two subchannels per drive; 
to zero if the disc type is 7900, 7901, or 2883 with four subchannels per drive. 

7. Start the computer executing. 

8. When DOS-Ill has been loaded into main memory, it prints the following message: 

INPUT :DATE,XXXXXXXXXX (No Time-base Generator) 

or 
INPUT .DATE, XXXXXXXXXX,H,M (Time-base Generator present) 

9. All other directives are ignored until a valid DATE directive is entered. Immediately following 
the DATE directive, the only valid directives are :TRACK, :BATCH, :TYPE, and : JOB. All 
others are ignored until one of these directives is entered. 
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BMDL 

The BMDL resides in the last 64 10 words of main memory (hardware protected by a button/switch 
on the computer front panel) and is responsible for loading main-memory resident modules from 
configured DOS-Ill systems residing on the disc into main memory. The BMDL also loads absolute 
binary programs into main memory through the paper tape input device. A separate version of the 
BMDL exists for each of two classes of disc, depending upon which disc type is used with the system 
(HP 7900/7901, or HP 2883/2884). Only one version can exist in main memory at any one time. The 
following two tables show the last 64 10 word addresses and their octal contents for each version of 
the BMDL. 

Note: When using the HP 7900/7901 BMDL with a newly -inserted 7900 or 7901 

disc cartridge, it is necessary to execute the bootstrap twice. After executing 
the bootstrap the first time, the system loops; it must be halted and the 
bootstrap executed a second time. This procedure does not apply to the 
Stand-alone Bootstrap. 







Table 11-1. HP 7900/790' 


1 BMDL 




Address 


Contents 


Address 


Contents 






x7700 


002701 


x7740 


1023kk 


Paper tape loader starting ad- 


x7701 


063722 


x7741 


027740 


dress = x7700 8 ; Moving-head 


X7702 


002307 


x7742 


1064kk 


disc 


loader starting address = 


x7703 


102077 


x7743 


002041 


x7750 8 (PRESET must be 


x7704 


017735 


x7744 


127735 


pressed). 


x7705 


007307 


x7745 


005767 






x7706 


027702 


x7746 


027737 






x7707 


077733 


X7747 


030000* 


x 


= 3 for 16k, 4 for 20k, 


x7710 


017735 


x7750 


002400 




5 for 24k, 6 for 28k, 


x7711 


017735 


x7751 


1026cc 




7 for 32k 


x7712 


074000 


x7752 


1037cc 






x7713 


077734 


x7753 


067747 






x7714 


067734 


x7754 


1066dd 


kk 


= tape input device 


x7715 


047777 


x7755 


1037dd 




select code 


x7716 


002040 


x7756 


1066cc 






x7717 


102055 


x7757 


063776 


dd 


= low priority (higher 


x7720 


017735 


x7760 


102606 




numbered) disc 


x7721 


040001 


x7761 


067732 




select code 


x7722 


177734 


x7762 


106602 






X7723 


037734 


x7763 


1037cc 


cc 


= high priority (lower 


x7724 


000040 


X7764 


102702 




numbered) disc 


x7725 


037733 


X7765 


106602 




select code 


x7726 


027714 


x7766 


013741 






x7727 


017735 


x7767 


1026dd 


n 


= 4 for 16k, 3 for 20k, 


X7730 


054000 


x7770 


1037cc 




2 for 24k, 1 for 28k, 


x7731 


027701 


x7771 


103706 




for 32k 


x7732 


102011 


x7772 


1037dd 






x7733 
x7734 


000000 
000000 


x7773 
x7774 


1023dd 
027773 


•The 
be a 


HP 7900/7901 BMDL can 
Itered to boot a DOS-Ill sys- 


x7735 


000000 


x7775 


127717 


tem 


from subchannel instead 


x7736 


006600 


x7776 


1200cc 


of subchannel 1 by changing the 
contents of address x7747 from 


x7737 


1037kk 


x7777 


1n0100 


30000 8 to31000g. 
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Table 11-2. HP 2883/2884 BMDL 



Address 


Contents 


Address 


Contents 




x7700 


002701 


x7740 


1023kk 


Paper tape loader starting ad- 


x7701 


063722 


x7741 


027740 


dress = x7700 8 ; Moving-head 


x7702 


002307 


x7742 


1064kk 


disc loader starting address = 


x7703 


102077 


x7743 


002041 


x7750 8 (PRESET must be 


X7704 


017735 


x7744 


127735 


pressed). 


x7705 


007307 


X7745 


005767 




x7706 


027702 


x7746 


027737 




x7707 


077733 


x7747 


177600 


x = 3 for 16k, 4 for 20k, 


x7710 


017735 


x7750 


063775 


5 for 24k, 6 for 28k, 


x7711 


017735 


x7751 


1026dd 


7 for 32k 


x7712 


074000 


x7752 


1037dd 




x7713 


077734 


x7753 


1023dd 




x7714 


067734 


x7754 


027753 


kk = tape input device 


x7715 


047777 


x7755 


067776 


select code 


x7716 


002040 


x7756 


106606 




x7717 


102055 


x7757 


067732 


dd = low priority (higher 


x7720 


017735 


x7760 


106602 


numbered) disc 


x7721 


040001 


x7761 


102702 


select code 


x7722 


177734 


x7762 


067747 




x7723 


037734 


X7763 


106602 


cc = high priority (lower 


x7724 


000040 


x7764 


001000 


numbered) disc 


x7725 


037733 


x7765 


1067dd 


select code 


x7726 


027714 


x7766 


1026dd 




x7727 


017735 


x7767 


1037cc 


n = 4 for 16k, 3 for 20k, 


x7730 


054000 


x7770 


103706 


2 for 24k, 1 for 28k, 


x7731 


027701 


x7771 


1037dd 


for 32k 


x7732 


102011 


x7772 


1023dd 




X7733 


000000 


x7773 


027772 




x7734 


000000 


x7774 


127717 




x7735 


000000 


x7775 


020000 




x7736 


006600 


x7776 


1200cc 




x7737 


1037kk 


x7777 


1n0100 
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PART 4 
DOS-Ill Systems Programming 



SECTION XII 
User-written EXEC Modules 



DOS-Ill is capable of accepting user-written EXEC modules. Up to two EXEC modules may be 
written; these must be loaded with all the DOS-Ill EXEC modules during DOS-Ill Generation. 
(See Section X, "Generating DOS-Ill" for details.) 

This section presents the user-written EXEC call directives and calling sequences, along with a brief 
description of internal design and a sample EXEC module. 

For example, DOS-Ill halts on power failure. The user may write a power fail recovery routine. 
Because of system requirements, the routine must be called $PFAL. 
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USER EXEC MODULES: DIRECTIVES 



Purpose 

To execute user EXEC modules. 

Format 

:EA[,pl,. . . ,p5] (Calls EXEC module $EX36) 

:EB[,pl,. . . ,p5] (Calls EXEC module $EX37) 

where all parameters are non-negative decimal integers. 

Comments 

Number and meaning of the parameters varies depending upon user definition of the EXEC module. 



12-2 



USER EXEC MODULES: EXEC CALLS 



Purpose 

To execute either user-created EXEC module $EX36 or $EX37. The number of parameters in the 
EXEC call are defined by the user. The general format of the call is 



Assembly Language 



EXT EXEC 



JSB EXEC 

DEF *+2 (to 7) 

DEF RCODE 

DEF PRAM1 



(Transfer control to DOS-HI) 

(Determine number of parameters— from 1 to 5) 

(Define request code) 

(Define the first optional parameter) 



PRAM5 



DEF PRAM5 (Define the fifth optional parameter) 



RCODE DEF 27 (or 28) (RCODE for $EX36 = 27; RCODE for $EX37 = 28) 

PRAM1 — (Up to five words of parameter information) 



FORTRAN 



IRCDE = 27 (or 28) 
CALL EXEC (IRCDE [,P1, 



■P5]) 
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USER EXEC MODULES: INTERNAL DESIGN 



EXEC modules are typically type-1 Assembly-language routines which are incorporated at genera- 
tion time as part of the operating system. As "system" modules, they execute with the interrupt 
system and memory protect off. They may directly access entry points and subroutines within the 
system, but must not issue any EXEC calls (EXEC processing is not re-entrant). Also, user-written 
EXEC modules should be defined as disc-resident supervisory modules; the NAM pseudo-instruction 
for these modules should indicate that the routine is a type-1 program. 

Special programming considerations are required upon initiation and completion. 



Initiation 

Upon entry, information used in processing the EXEC function can be found in the following base 
page locations. 



Location 


Name 


224 8 


RQCNT 


225 8 


RQRTN 


226 8 


RQP1 


227-233 8 


RQP2-RQP6 



Definition 

# of parameters in the calling sequence 
return address upon completion 
address of request code 
address(es) of specified parameters 



Completion 

Prior to returning to the system, the EXEC module must 

1. release itself from the EXEC module overlay area if it is disc-resident. This code handles EXEC 
module release: 





LDA EXMOD 


(Get current module in overlay area) 




CPA NUMB 


(Is it this one?) 




CMAJNA 


(Yes— set value positive) 




STA EXMOD 


(No— leave value alone) 


EXMOD 


EQU 245B 




NUMB 


DEC -36 (or - 


37) 
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2. place the desired transfer address in XIRT (location 137 8 ) and jump to the label $IRT 
(defined as an EXTernal), for example, 





EXT 


$IRT 




LDA 


RQRTN 




STA 


XIRT 




JMP 


$IRT 


RQRTN 


EQU 


225B 


XIRT 


EQU 


137B 



(Set the return address) 
(Transfer to system) 
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SAMPLE EXEC MODULE 



PAGE 0001 



0001 ASMB,UC,X,N,R,B DISC WORK LIMITS MODULE (SEX02) 

♦* NO ERRORS* 
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PAGE 0002 #01 



0001 
0002 

0003 

0004 

0005 

0006* 

0007* 

0008* 

0009* 

0010* 

0011* 
0012* 

0013* 

0014* 

0015* 

0016* 

0017* 

0018* 

0019* 

0020 

0021 

0022 

0023 

0024 

0025 

0026 

0027 

0028 

0029 

0030 

0031 

0032 

0033 

0034 

0035 

0036 

0037 

0038 

0039 

0040 

0041 

0042 

0043 
0044 
0045 
0046 
0047 
0048 
0049 
0050 
0051 
0052 



ASMBfL,C,X,N,R,B DISC WORK LIMITS MODULE (SEX02) 
00000 NAM $EX02,1 

ENT SEX02 
EXT SRQER, SADDR 
EXT SIRT 
SEX02 ROUTINE PROVIDES THE USER WITH DISC WORK AREA TRACK 
ADDRESS LIMITS AND THE * OF SECTORS PER DISC TRACK, 

CALLING SEQUENCE! 



JSB EXEC 
DEF **5(0R 6) 
DEF RCODE 
DEF FTRAK 
DEF LTRAK 
DEF SIZE 



RCODE « 17 

FTRAK * ADDR OF WORD TO STORE 1ST WORK TRK 
LTRAK « ADDR OF WORD TO STORE LAST WORK TRK 
SIZE ■ * SECTOR/TRACK WORD ADDR. 



DEF DISC(OPTIONAL) 



DISC ■ FOR SYSTEM DISC, NON-0 FOR US 
DEFAULT IS SYSTEM. 



00000 
00001 
00002 
00003 
00004 
00005 
00006 
00007 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00040 



060224 

050057 

026010R 

050060 

002001 

026065R 

060232 

016002X 

060227 

016002X 

060230 

016002X 

060231 

016002X 

064224 

054057 

026024R 

160232 

002002 

026057R 

060160 

040074 

001727 

010074 

170227 

060102 

002003 

026043R 

010074 

070001 

020102 

001727 

010074 



CHK 



SEX02 LDA 
CPA 
JMP 
CPA 
RSS 
JMP 
LDA 
JSB 
LDA 
JSB 
LDA 
JSB 
LDA 
JSB 
LOB 
CPB 
JMP 
LDA 
SZA 
JMP 
LDA 
ADA 
ALF, 
AND 
STA 
LDA 
SZA, 
JMP 
AND 
STA 
XOR 
ALF, 
AND 



SYS 



RQCNT 
..♦4 

CHK 
..♦5 

RQER 

RQP5 

SADDR 

RQP2 

SADDR 

RQP3 

SADDR 

RQP4 

SADDR 

ROCNT 

..*4 

SYS 
RQP5,I 

USER 

SYNTS 

,377 

ALF 

,377 

RQP2,I 

JBINC 

RSS 

EX010 

.377 

B 

JBINC 

ALF 

,377 



CHECK PARAMETER COUNT 

4 PARAMETERS? 

YES. OK, 
5 PARAMETERS? 
YES, OK 

TOO FEW OR TOO MANY PARAMETERS. 

CHECK ADDR OF 5TH PARAM 



PARAMETERS 



DEFAULT AS SYSTEM DISC? 
YES. 
NO, CHECK 5TH PARAM 
MEANS SYSTEM DISC 

GET START OF WORK AREA TRACK 
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PAGE 0003 #01 



0053 


00041 


040052 




ADA 


Nl 


0054 


00042 


026045R 




JMP 


EX020 


0055 


00043 


060154 


EX010 


I.DA 


DISCO 


0056 


00044 


010074 




AND 


.377 


0057 


00045 


170230 


EX020 


STA 


RQP3,I 


0058 


00046 


060116 




IDA 


SECTR 


0059 


00047 


170231 




STA 


RQP4,I 


0060 


00050 


080245 




LDA 


EXMOD 


0061 


00051 


050051 




CPA 


• •'•2 


0062 


00052 


003004 




CMA, 


INA 


0063 


00053 


070245 




STA 


EXMOD 


0064 


00054 


060225 




LDA 


RQRTN 


0065 


00055 


070137 




STA 


XIRT 


0066 


00056 


026003X 




JMP 


$!RT 


0067 


00057 


060157 


USER 


LDA 


UDNTS 


0068 


00060 


040074 




ADA 


,377 


0069 


00061 


001727 




ALF, 


ALF 


0070 


00062 


010074 




AND 


,377 


0071 


00063 


170227 




STA 


RQP2,I 


0072 


00064 


026043R 




JMP 


EX010 


0073 


00065 


002400 


RQER 


CLA 




0074 


00066 


070245 




STA 


EXMOD 


0075 


00067 


026001X 




JMP 


SRQFR 


0076* 












0077 


00000 




A 


EOU 





0078 


00001 




B 


ECU 


1 


0079 


00053 




t • 


EOU 


53B 


0080 


00052 




Nl 


EQU 


..-1 


0081 


00074 




,377 


EOU 


.,♦17 


0082 


00100 




• 


EQU 


100B 


0083 


00102 




JBINC 


EOU 


.♦2 


0084 


00116 




SECTR 


EQU 


.♦14 


0085 


00t26 




RONBF 


EQU 


,*26B 


0086 


00137 




XIRT 


EQU 


RONBF+9 


0087 


00154 




DISCO 


EQU 


,♦44 


0088 


00157 




UONTS 


EQU 


.♦47 


0089 


00160 




3YNTS 


EQU 


• ♦46 


0090 


00?24 




ROCNT 


EQU 


,♦84 


0091 


00225 




RORTN 


EQU 


,♦85 


0092 


00227 




RQP2 


EQU 


,♦87 


0093 


00230 




RQP3 


EQU 


,♦88 


0094 


00231 




RQP4 


EQU 


,♦89 


0095 


00232 




R0P5 


EQU 


,♦90 


0096 


00245 




EXMOD 


EQU 


.♦101 


0097 








END 




♦+ NO ERROR 


S* 









STORE END OF WORK AREA TRACK # 
STORE « OF SECTORS PER TRACK 



SET UP TRANSFER ADDR FOR SIRT 



GET USER DISC NEXT TR/SECTR 



FREE MODULE AREA 
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SEX02 


CROSS-R 


EFERENCE 


SYMBOL TA 


BLE 


PAGE 00 


01 


SADDR 


00004 


00027 


00029 


00031 


00033 






SEX02 


00020 


00003 












$IRT 


00005 


00066 












SRQER 


00004 


00075 












t 


00082 
00090 


00083 
00091 


00084 
00092 


00085 
00093 


00087 
00094 


00088 
00095 


00089 
00096 


t * 


00079 


00021 


00023 


00035 


00061 


00080 


00081 


,377 


00081 
00070 


00041 


00043 


00048 


00052 


00056 


00068 


• A 


m%77 














B 


00078 


00049 












CHK 


00028 


00022 












DISCO 


00087 


00055 












EX010 


00055 


00047 


00072 










EX020 


00057 


00054 












EXMOD 


00096 


00060 


00063 


00074 








JBINC 


00083 


00045 


00050 










Nl 


00080 


00053 












RONBF 


00085 


00086 












RQCNT 


00090 


00020 


00034 










RQER 


00073 


00025 












R0P2 


00092 


00028 


00044 


00071 








RQP3 


00093 


00030 


00057 










RQP4 


00094 


00032 


00059 










RQP5 


00095 


00026 


00037 










RQRTN 


00091 


00064 












SECTR 


00084 


00058 












SVNTS 


00089 


00040 












SYS 


00040 


00036 
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SEX02 CROSS-REFERENCE SYMBOL TABLE PAGE 0002 



UDNTS 


00088 


00067 


USER 


00067 


00039 


XIRT 


00086 


00065 
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SECTION XIII 
Planning I/O Drivers 



STANDARD I/O DRIVERS 



Note: Before attempting to program an I/O driver, the programmer should be 

thoroughly familiar with Hewlett-Packard computer hardware I/O organi- 
zation, interface kits, computer I/O instructions, and Direct Memory Access 
(DMA). 



An I/O driver, operating under control of the Input/Output Control ($EX18) and Central Interrupt 
Control ($CIC) modules of DOS-Ill, is responsible for all data transfer between an I/O device and 
the computer. During its execution, the driver may refer to the base page communication area for 
information from the system: the device equipment table (EQT) entry, which contains the param- 
eters of the transfer, and the current DMA value (CHAN), which contains the number of the 
allocated DMA channel (if required). 

An I/O driver includes two relocatable, closed subroutines: the Initiation Section and the Completion 
Section. If nn is the octal equipment type code of the device, l.nn and C.nn are the entry point 
names of the two sections and DVRnn is the driver name. 



Initiation Section 

The I/O control module ($EX18) calls the initiation section directly when an I/O transfer is initiated. 
Locations EQT1 through EQT17 of the base page communication area contain the addresses of the 
appropriate EQT entry. CHAN in the base page contains the number of the DMA channel assigned 
to the device, if needed. This section is entered by a jump subroutine (JSB) to the entry point l.nn. 
On entry, the A register contains the select code (channel number) of the device (bits through 5 of 
EQT entry word 3). The driver returns to $EX18 by an indirect jump through l.nn. 

Before transferring to l.nn, DOS-Ill places the request parameters from the user program's EXEC call 
into words 7 through 13 of the EQT entry. Word 9, CONWD, is modified to contain the request code 
in bits through 5 in place of the logical unit. (See Figure A-4 and Section III, I/O READ /WRITE 
EXEC Call (RCODE = 1 or 2), for details of the parameters.) 

Once initiated, the drive can use words 5, 6, and 11 through 14 of the EQT entry in any way, but 
words 1, 2, 3, 7, 8, 9, 10, 15, 16, and 17 must not be altered. The driver updates the status field in 
word 4, if appropriate, but the rest of word 4 must not be altered. 
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FUNCTIONS OF THE INITIATION SECTION: The initiation section is responsible for these 
functions (as flow-charted in Figure 13-1): 

1. Rejects the request and proceeds to step 5 if: 

• the device is inoperable, or 

• the request code, or other of the parameters, is illegal. 

Note: All drivers must accept a clear request. (Request code = 3, function code = .) 

2. Configures all I/O instructions in the driver to include the select code of the device (or DMA 
channel). (Does not apply to DVR05 and 7900/7901 DVR31.) 

3. Initializes DMA, if appropriate. 

Note: The initiation section must save the DMA channel number (found in CHAN) 
in the EQT entry, since it is not set on entry to the continuation section. 

4. Initializes software flags and activates the device. All variable information pertinent to the 
transmission must be saved in the EQT entry because the driver may be called for another 
device before the first operation is complete. 

5. Returns to $EX18 with the A register set to indicate initiation or rejection and the cause of 
the reject: 

If A = 0, then the operation was initiated. 

If A f 0, then the operation was rejected with A set as: 

1 = read or write illegal for device 

2 = control request illegal or undefined 

3 = equipment malfunction or not ready 

4 = immediate completion (for control requests) 

6 = driver cannot handle a control request; the system is instructed to wait 
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( '■"" ) 



return 

to 

P+1 



(A) = 1 or 

2 reject 

codes 



NO 



<A) - 3, 
reject 
code 



configure 

I/O instructions 

for device 




YES 




YES 



initialize 

operating, 

conditions, 

flags, etc. 



set buffer 
address, length, 
mode, etc. for 
transfer 



(activate A 
device J 



1 


' 


A register 
(A) = 4 or 


i 


> 


return to 
P+1 



Figure 13-1. I/O Driver initiation Section 
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Completion Section 

DOS-Ill calls the completion section of the driver whenever an interrupt is recognized on a device 
associated with the driver. Before calling the driver, $CIC sets the EQT entry addresses in base page, 
sets the interrupt source code (select code) in the A register, and clears the I/O interface or DMA 
flag. The calling sequence for the completion section is 

Location Action 

Set A register equal to interrupt source code 
P JSB Cnn 

P+l Completion return from Cnn 

P+2 Continuation return from Cnn 

The point of return from Cnn to $CIC indicates whether the transfer is continuing or has been 
completed (in which case, end-of-operation status is returned also). 



FUNCTIONS OF THE COMPLETION SECTION: The completion section of the driver is responsible 
for the functions below (as flow-charted in Figure 13-2): 

1. The driver configures all I/O instructions in the completion section to reference the interrupting 
device. 

2. If both DMA and device completion interrupts are expected and the device interrupt is 
significant, the DMA interrupt is ignored by returning to $CIC in a continuation return. 

3. Performs the input or output of the next data item if the device is driven under program 
control. If the transfer is not completed, the driver proceeds to step 6. 

4. If the driver detects a transmission error, it can re-initiate the transfer and attempt a 
retransmission. A counter for the number of retry attempts can be kept in the Equipment 
Table. The return to $CIC must be (P+2) as in step 6. 

5. At the end of a successful transfer or after completing the retry procedure, the following 
information must be set before returning to $CIC at (P+l): 

a. Set the actual or simulated device status into bits through 7 of EQT word 4. 

b. Set the number of transmitted words or characters (depending on which the user 
requested) in the B register. 

c. Set the A register to indicate successful or unsuccessful completion. 

= successful completion 

1 = device malfunction or not ready 

2 = end-of-tape (information) 

3 = transmission parity error 
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6. Clear the device and DMA control on end-of-operation, or set the device and DMA for the 
next transfer or retry. Return to $CIC at 

(P+l) completion, with the A and B registers set as in step 5 

(P+2) continuation; the registers are not significant. 
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YES 



device 
interrupt 
required 
? 



YES 



( c.™ ) 


1 


configure 

I/O instructions 

for device 


S>r transfer ^^ 
^ by DMA _,, 



no 



error 
in ^> 


s' end 
<L 0f 


transfer 


^v. operation 
— ~> s 



YES 







)J^^ 


' retry 

required ^> 








[yes 




update 

status in 

EQT(4) 




re-initialize 
conditions 




' 


> 






(B) = # 
words or 
characters 
transferred 




' 


' 






return 

to 

P+2 








' 


> 






(A) = 

completion 

code 












' 


t 






clear 
device 
control 






' 


' 






return 

to 

P+1 



NO 



transfer next 

data item; 

update indexes, 

flags, etc. 



return 

to 

P+2 



Figure 13-2. I/O Driver Completion Section 
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SAMPLE I/O DRIVER 

The following pages provide an assembly listing and cross-reference symbol table for a sample I/O 
driver. 
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PAGE 0001 



0001 

** NO ERSOPS* 



ASMB^B,UC 



13-8 



PAGE 0002 #01 ** 0.0, s, DRIVEP <02> PAPER TAPE PUNCH ** 



0001 

0003 

0004* 

0005* 

0006* 

0007* 

0008 

0009* 

0010* 

0011* 

0012* 

0013* 

0014* 

0015* 

0016* 

0017* 

0018* 

0019* 

0020* 

0021* 

0022* 

0023* 

0024* 

0025* 

0026* 

0027* 

0028* 

0029* 

0030* 

0031* 

0032* 

0033* 

0034 + 

0035* 

0036* 

0037* 

0038* 

0039* 

0040* 

0041* 

0042* 

0043* 

0044* 

0045* 

0046* 

0047* 

0048* 

0049* 

0050* 

0051* 

0052 + 

0053* 

0054* 

0055* 

0056* 

0057* 



ASMB,R,B,L,C 

00000 NAM DVR02,4 

********* VERSION 8/24/72 



ENT I. 02, C, 02 

***** PROGRAM DESCRIPTION ******* 

DRIVER 02 OPERATES UNDER THE CONTROL OF THE 
I/O CONTROL. MODULE OF THE D.O.S. EXECUTIVE 
THIS DRIVER IS RESPONSIBLE FOR CONTROLLING 
OUTPUT DATA TRANSMISSION WITH A 2753A TAPE PUNCH, 
<02> IS THE EQUIPMENT TYPE CODE ASSIGNED TO THIS 
TYPE OF DEVICE. 1.02 IS THE ENTRY POINT FOR THE 
♦INITIATION* SECTION AND C.02 FOR THE *COMPLETION* 
SECTION. 

- THE INITIATION SECTION IS CALLED FROM I/O 
CONTROL TO INITIALIZE A DEVICE AND INITIATE 
AN OUTPUT OR CONTROL OPERATION, 

CALLING SEQUENCE: 

- ADDRESSES OF DEVICE EQT ENTRY 
SET IN "EGT1-EQT17" » 

(A) ■ I/O ADDRESS OF DEVICE 

(P) JSB 1.02 
CP+1) - RETURN - 

(A) » 0, OPERATION INITIATED, OR 
(A) ■ REJECT CODEJ 

i, ILLEGAL READ REQUEST 

2# ILLEGAL CONTROL FUNCTION 



THE COMPLETION SECTION IS CALLED BY CENTRAL 
INTERRUPT CONTROL TO CONTINUE OR COMPLETE 
AN OPFRATION. 

CALLING SEQUENCE: 

- ADDRESSES OF DEVICE EQT ENTRY 
SET IN "EQT1-EQT17" - 

(A) • I/O ADDRESS OF DEVICE 

(P) JSB C.02 

(p+1) -- COMPLETION RETURN 

(P*2) — CONTINUATION RETURN — 

- COMPLETION RETURN! 
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PAGE 0003 *01 ** D.O.St DRIVER <02> PAPER TAPE PUNCH ** 



0058* 
0059* 
0060* 
0061* 
0062* 
0063* 
0064* 
0065* 
0066* 
0067* 
0068* 
0069* 
0070* 
0071* 
0072* 
0073* 
0074* 
0075* 
0076* 
2Q77* 
0078* 
0079* 
0080* 
0081* 
0082* 
0083* 
0084* 
0085* 
0086* 
0087* 
0088* 
0089* 
0090* 
0091* 
0092* 
0093* 
0094* 
0095* 
0096* 
0097* 
0098* 
0099* 



(A) • 0, SUCCESSFUL COMPLETION WITH 
(B) » U WORDS OR CHARACTERS 
TRANSFERRED. 
(A) « 2 IF *TAPE«SUPPLY-LOW* CONDITION 
DETECTED AFTER RECORD IS 
FINISHED, 
(B), SAME AS FOR (A) « 

- CONTINUATION RETURN: REGISTERS 
MEANINGLESS 



- RECORD FORMATS: 

ASCII: A STRING OF CHARACTERS, THE NUMBER 
..... DESIGNATED BY THE BUFFER LENGTH IN 
THE REQUEST, TERMINATED BY A RETURN 
AND LINE-FEED (SUPPLIED BY THE DRIVER), 

SPECIAL CHARACTER PROCESSINGS 

LEFT-ARPOWf IF A LEFT-ARROW IS THE LAST 
CHARACTER IN THE USER BUFFER, 
THE RETURN/LINE-FEED AND LEFT 
ARROW CODES ARE NOT OUTPUT. 

A ZERO BUFFER LENGTH CAUSES ONLY A RETURN/ 
LINE-FEED TO BF OUTPUT. 

BINARY: A STRING OF CHARACTERS SPECIFIED 
...... R y THE "BUFFER LENGTH" IN' THE REQUEST, 



CONTROL FUNCTIONS ACCEPTED: 

10 - TEN INCHES OF ZEROS (FEED-FRAMES) ARE 
OUTPUT FOR LEADER/TRAILER. 

11 - LINE SPACING: THE PARAMETER WORD OF THE 
CONTROL REQUEST DETERMINES THE NUMBER 
OF LINE-FEEDS TO BE OUTPUT. 
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PAGE 0004 #01 < DRIVER 02 *INITIATION* SECTION > 



0101* 










0102********* INITIATION 


SECTION ********** 


0103* 










0104* 










0105 


00000 000000 


1.02 


NOP 




0106* 










0107 


00001 016201R 




JSB SETIO 


SET I/O INSTRUCTIONS FOR UNIT, 


0108* 










0109 


00002 160213 




LDA EGT9,I 


GET CONTROL WORD OF REQUEST, 


0110 


00003 010056 




AND .3 


ISOLATE. 


0111* 










01J2 


00004 050054 




CPA ,1 


ERROR IF REQUEST IS 


0U3 


00005 126000R 




JMP 1.02,1 


FOR INPUT, REJECT CALL. 


0114 


00006 050055 




CPA .2 


PROCESS FOR 


0115 


00007 026043R 




JMP D04 


WRITE REQUEST. 


0116* 










0117* 


CONTROL FUNCTION REQUEST 




0118* 










0119 


00010 160213 




LDA EQT9,I 


GET CONTROL WORD 


0120 


00011 001727 




ALF,ALF 


FROM REQUEST, POSITION AND 


0121 


00012 001222 




RAL,RAL 


ISOLATE FUNCTION FIELD, 


0122 


00013 010073 




AND MASK1 




0123 


00014 002003 




SZA.RSS 


IS IT A CLEAR? 


0124 


00015 026024R 




JMP CLEAR 


YES. 


0125 


00016 050063 




CPA ,10B 


FIELD « <10> TO GENERATE 


0126 


00017 026026R 




JMP D01 


LEADER (10 INCHES OF BLANK TAPE) 


0127 


00020 050064 




CPA ,UB 


FIELD « <U> FOR LINE 


0128 


00021 026032R 




JMP D02 


SPACING, 


0129* 










0130* 


REQUEST ERROR 


- CAUSE REJfC? RETURN TO I/O CONTROL 


0131* 










0132 


00022 060055 




LDA .2 




0133 


00023 126000R 




JMP 1.02,1 




0134 


00024 106700 


CLEAR 


CLC 


TURN DEVICE OFF 


0135 


00025 026066R 




JMP I. A. 6 




0136* 










0137* 


LEADER/TRAILEF 


\ GENERATOR 




0138* 










0139 


00026 062224R 


001 


LDA N100 


SET INDEX COUNTER FOR FEED FRAMES 


0140 


00027 170216 




STA EQT12,I 


■ -100, 


0141 


00030 002400 




CLA 


(A) ■ FOR 


0142 


00031 026041R 




JMP D03 


FEED FRAME, 


0143* 










0144* 


LINE SPACING 








0145* 










0146 


00032 160214 


D02 


LDA EQT10,I 


GET LINE COUNTER WORD, 


0147 


00033 002021 




SSA,R5S 


INSURE VALUE 


0148 


00034 003004 




CMA,INA 


IS NEGATIVE. 


0149 


00035 002003 




SZA,RSS 


PROTECT AGAINST 


0150 


00036 003400 




CCA 


A ZERO VALUE. 


0151 


00037 170216 




STA EQT12,I 




0152 


00040 060065 




LDA LINF 


(A) » LINE FEED CODE. 


0153* 










0154 


00041 170217 


D03 


STA EQT13,I 


SET ACTION CODE, 


0155 


00042 026056R 




JMp D05 




0156* 
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0157* 
0158* 
0159 
0160 

0161 

0162 

0163 

0164 

0165 

0166 

0167 

0168* 

0169 

0170 

0171* 

0172* 

0173* 

0174 

0175 

0176 

0177* 

0176 

0179 

0180 

0181* 

0182 

0183 

0184 

0185 



WRITE REQUEST PROCESSING 



00043 
00044 

00045 
00046 
00047 

00050 
00051 
00052 

00053 



160214 
001200 
170216 
160215 
002020 

026053R 
001000 
003004 
170217 



00054 002400 

00055 170220 



D04 LDA EGT10,I 
RAL 

STA EGT12,I 

IDA EQTM,I 
SSA 

JMp *+3 
ALS 

CMA,INA 

STA EQT13,I 

CLA 

STA EQT14,I 



CONVERT BUFFER ADDRESS TO EVEN 
CHARACTER ADDRESS AND SET 
AS CURRENT BUFFER ADDRESS, 

GET BUFFER LENGTH. 

IF CHARACTER SPECIFIED, 
USE VALUE, 

CONVERT WORDS TO NEGATIVE 
CHARACTERS, 

SET CURRENT BUFFER LENGTH, 



FOR BINARY WRITE. 
CALL *COMPLETION* SECTION TO WRITE FIRST CHAR. 



00056 062223R 

00057 072070R 
00060 026075R 



D05 



00061 026064R 

00062 002400 IEXIT 

00063 126000R 



LDA 
STA 
JMP 

JMP 
CLA 
JMP 



IEXTA 
C.02 

D10 

I. A. 4 
1.02,1 



ADJUST RETURN 
TO INITIATOR* SECTION, 



BINARY READ WITH BUFFER 
RETURN TO I/O CONTROL WITH 
OPERATION INITIATED. 



LEN. 



00064 006400 I.A.4 CLB 

00065 174220 STB EQT14,I 

00066 060057 I. A. 6 LDA ,4 

00067 126000R JMP 1.02,1 



CLEAR TLOG, 
SET A«4 FOR IMMED.COMPL RETURN 
RETURN 
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0187* 

0188* 

0189* 

0190* 

0191 

0192* 

0193 

0194 

0195 

0196 

0197* 

0198 

0199 

0200 

0201 

0202 

0203* 

0204 

0205 

0206 

0207* 

0208 

0209 

0210* 

0211 

0212 

0213* 

0214 

0215 

0216 

0217 

0218 

0219 

0220 

0221* 

0222 

0223 

0224 

0225* 

0226 

0227 

0228* 

0229 

0230 

0231* 

0232* 

0233* 

0234 

0235 

0236 

0237 

0238* 

0239* 

0240* 

0241 

0242 



******** COMPLETION SECTION ********** 



00070 000000 C.02 NOP 



00071 
00072 
00073 
00074 

00075 
00076 
00077 
00100 
00101 



016201R 
160207 
002020 
026155R 

160213 
070001 
001727 
001200 
072222R 



00102 002400 

00103 150216 

00104 026155R 



00105 
00106 

00107 
00110 

00111 
00112 
00113 
00114 
00115 
00116 
00117 



004010 
026133R 

150217 
026137R 

164216 
134216 

004065 
160001 
002041 
001727 
010074 



00120 066222R 

00121 134217 

00122 026127R 

00123 006020 

00124 026127R 

00125 052220R 

00126 026155R 



JSB SETIO 
LDA E0T5,I 
SSA 
JMP 103 

D10 LDA EGT9,I 
STA 8 
ALF,ALF 
RAL 
STA TEMPI 

CLA 

CPA EQT12,I 

JMP 103 

SLB 
JMP Dll 

CPA EGT!3,I 
JMP D12 

LDB EQT12,! 
ISZ EGT12,I 
CLE,ERB 
LDA B,I 
SEZ,RSS 
ALF,ALF 
AND MASK3 

LDB TEMPI 
ISZ EQT13,I 
JMP 101 

SSB 
JMP 101 

CPA ARROW 
JMP 103 



OUTPUT CHARACTER TO PUNCH UNIT, 



00127 102600 

00130 102700 

00131 036070R 

00132 126070R 



101 OTA 

102 STC 
ISZ C.02 
JMP C.02, I 



CONTROL FUNCTION OUTPUT 



00133 160217 

00134 134216 



Dll LDA E0T13,I 
ISZ EQT12,I 
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SET I/O INSTRUCTIONS FOR UNIT, 
GET "CLEAR" FLAG, 
CLEAR? 
YES. TERMINATE. 

GET CONTROL WORD 

SAVE FOR CODE TEST, 
ROTATE MODE BIT 

TO BIT 15 

AND SAVE, 

IF CURRENT BUFFER ADDRESS OR 
FUNCTION INDEX ■ 0, THEN 
OPERATION COMPLETED. 



• CONTROL FUNCTION - 

IF CURRENT CHARACTER INDEX ■ 
0, THEN OUTPUT END OF RECORD, 

GET CURRENT CHAR, BUFFER ADDRESS. 
ADD 1 FOR NEXT CHARACTER. 
CONVERT TO WORD ADDRESS, 
GET WORD AND 

POSITION PROPER 

CHARACTER IN A(07-00). 
REMOVE UPPER POSITION DATA. 

PUT MODE IN BC15), 
INDEX CHARACTER COUNTER, 
- NOT LAST CHARACTER. 

IF BINARY MODE, 
WRITE LAST CHARACTER. 

IF CHAR « < «• >, THEN OMIT IT 
AND R/LF ON ASCII RECORD, 



OUTPUT CHARACTER TO INTERFACE 
TURN DEVICE ON. 
ADJUST RETURN TO (P*2). 
-EXIT-, 



(A) ■ LINE-FEED OR FEED FRAME, 
INDEX OUTPUT COUNT FOR LEADER/ 
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0243 

0244 

0245* 

0246* 

0247* 

0248 

0249 

0250 

0251* 

0252 

0253 

0254 

0255 

0256 

0257 

0258 

0259 

0260* 

0261* 

0262 

0263 

0264 



00135 000000 

00136 026127R 



END OF RECORD PROCESSING 



00137 062222R 
00140 002020 
00M1 026155R 



00142 
00143 
00144 
00145 
00146 
00147 
00150 
00151 



164220 

062217R 

056217R 

060065 

170220 

056217R 

026152R 

026127R 



D12 



00152 006400 

00153 174216 

00154 026127R 



D14 



NOP 
JMP 101 




SING 




IDA TEMPI 
8SA 
JMP 103 




LDB EQT14, 
IDA RETN 
CPB RETN 
IDA LINF 
STA EQT14, 
CPB RETN 
JMp D14 
JMP 101 


I 
I 


CLB 

STB EQT12, 

JMP 101 


I 



TRAILER OR LINE SPACING, 
GO TO OUTPUT CHARACTER. 



CHECK MODE OF TRANSFER. 

- BINARY - 

♦ASCII* RECORD 
OUTPUT FIRST A 
RETURN AND THEN A 
LINE-FEED. 
SET EQT11 FOR LINE-FEED CHECK, 
IF LINE-FEED IS BEING OUTPUT, 
GO TO SET COMPLETION FLAG, 
- OUTPUT RETURN - 



SET BUFFER ADDRESS » 
TO INDICATE LAST CHARACTER. 
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0266* 

0267* 

0266* 

0269 

0270 

0271 

0272 

0273 

0274 

0275 

0276 

0277 

0278 

0279 

0280 

0261* 

0262 

0283 

0284 

0285* 

0286 

0287* 

0288 

0289* 

0290 

0291 

0292 

0293* 

0294* 

0295* 

0296* 

0297* 

0298* 

0299* 

0300* 

030}* 

0302* 

0303* 

0304 

0305 

0306 

0307* 

0308 

0309 

0310* 

0311 

0312 

0313* 

0314 

0315 

0316 

0317* 

0318 



STATUS AND TRANSMISSION COMPLETION SECTION 



00155 102500 103 

00156 070001 

00157 160206 

00160 010075 

00161 030001 

00162 170206 

00163 002400 

00164 006002 

00165 060055 

00166 164207 

00167 006020 

00170 026176R 

00171 164215 

00172 006020 

00173 007004 

00174 106700 104 

00175 126070R 

00176 006400 105 

00177 174207 
00200 126070R 



LIA 

STA B 

LDA EQT4,I 

AND MASK2 

IOR B 

STA E0T4 r I 

CLA 

SZB 

LDA .2 

LDB EQT5,I 

SSB 

JMP 105 

LDB EGTU,I 

SSB 

CMB, INB 

CLC 

JMP C.02,I 

CLB 

STB EQT5,I 

JMP C.02,1 



GET DEVICE STATUS, 

REMOVE PREVIOUS 

STATUS. 
SET NEW 

STATUS WORD. 
IF LOW TAPE 

SUPPLY, SET 

A * 2 FOR *EOT*. 

GET "CLEAR" FLAG. 

CLEAR? 

YES, 

SET (B) » TRANSMISSION 
LOG AS POSITIVE # OF WORDS 
OR CHARACTERS, 

TURN DEVICE OFF, 

AND EXIT FOR COMPLETION, 



RESET "CLEAR" FLAG, 
RETURN 



SUBROUTINE! <SETI0> 

»U*POSEt TO CONFIGURE THE I/O INSTRUCTIONS 
IN THE DRIVER TO REFERENCE THE 
SUBJECT PAPER TAPE PUNCH. 

CALL* (A)05-00 CONTAINS I/O ADDRESS 
(P) JSB 3ETI0 
(P*l) -RETURN- (REGISTERS MEANINGLESS) 



00201 000000 SETIO NOP 



00202 032221R 

00203 072155R 

00204 040067 

00205 072127R 

00206 042215R 

00207 072130R 

00210 032216R 

00211 072174R 

00212 072024R 

00213 126201R 



IOR LIA 
STA 103 

ADA ,100 
STA 101 

ADA ,1100 
STA 102 

IOR ,4000 
STA 104 
STA CLEAR 

JMP SETIO, I 



COMBINE <LIA> WITH I/O ADDRESS 
AND SET. 

CONSTRUCT «OTA> INSTRUCTION 
CONSTRUCT <STC,C> INSTRUCTION 
CONSTRUCT <CLC> INSTRUCTION 
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0320* 

0321* 

0322* 

0323 

0324 

0325* 

0326 

0327 

0328 

0329* 

0330* 

0331 

0332 

0333* 

0334 

0335* 

0336 

0337* 

0338 

0339 

0340* 



CONSTANT AND VARIABLE STORAGE AREA 



00300 
00401 

00P14 
00215 
00216 



00217 
00220 



A 
B 



00004(9 

001100 

004000 



000015 
000137 



,40 



,1100 
,4000 



retn 

ARROW 



EQU 
EOU 

OCT 
OCT 
OCT 



OCT 
OCT 





1 

40 

1100 

4000 



15 
137 



00221 102500 LIA LIA 



00222 000000 TEMPI NOP 



DEFINE SYMBOLIC REFERENCE FOR 
A AND B REGISTERS, 



00223 
00224 



000061R 
177610 



IEXTA 

N100 



DEF 
DEC 



IEXIT-1 

-120 
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0342* 




0343*** SYSTEM 


0344* 




0345 


00053 


0346 


00047 


0347 


00054 


0348 


00055 


0349 


00056 


0350 


00057 


0351 


00061 


0352 


00063 


0353 


00064 


0354 


00065 


0355 


00067 


0356 


00073 


0357 


00074 


0358 


00075 


0359 


00100 


0360* 




0361* 




0362* 


I/O MODU 


0363* 




0364 


00203 


0365 


00204 


0366 


00205 


0367 


00206 


0368 


00207 


0369 


00210 


0370 


00211 


0371 


00212 


0372 


00213 


0373 


00214 


0374 


00215 


0375 


00216 


0376 


00217 


0377 


00220 


0378 


00221 


0379 


00222 


0380 


00223 


0381 




** NO errors* 



PAGE COMMUNICATION AREA *** 



i • 


EQU 


53B 


N4 


EOU 


».-4 


.1 


EQU 


.. + 1 


.2 


EOU 


..♦2 


.3 


EOU 


,.*3 


.4 


EOU 


..*4 


.6 


EOU 


.. + 6 


.IBB 


EQU 


..♦8 


• 1 IB 


EOU 


..♦9 


LINF 


EQU 


.. + 10 


,100 


EOU 


..♦12 


MASKl 


EQU 


..*16 


MASK3 


EQU 


.. + 17 


MASK2 


EQU 


.. + 18 


• 


EQU 


100B 



ESTABLISH ORIGIN OF AREA 



!VER COMMUNICATION 



EQT1 


EQU 


.♦67 


E0T2 


EQU 


,♦68 


EQT3 


EQU 


#♦69 


EQT4 


EQU 


,♦70 


EQT5 


EQU 


.+71 


EQT6 


EOU 


,*72 


EQT7 


EQU 


,♦73 


EQT8 


EOU 


,♦74 


E0T9 


EQU 


,♦75 


EQT10 


EQU 


,♦76 


EQTU 


EQU 


. + 77 


EQT12 


EQU 


,♦78 


EQT13 


ECU 


,♦79 


EQT14 


EQU 


.♦80 


E0T15 


EQU 


,♦81 


EQT16 


EQU 


,♦82 


EQT17 


EQU 
END 


,♦83 
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DVRS 


!2 


CROSS-RF 


FERFNCE S 


iYMROL TABLE 




PAGE 0001 




t 


00359 
00370 
00377 


00364 
00371 
00378 


00365 
00372 
00379 


00366 
00373 
00380 


00367 
00374 


00368 
00375 


00369 
00376 


t • 


00345 
00352 


00346 
00353 


00347 
00354 


00348 
00355 


00349 
00356 


00350 
00357 


00351 

00358 


.1 


00347 


00112 












,100 


00355 


00308 












,10B 


00352 


00125 












,1100 


00327 


00311 












iHB 


00353 


00127 












.2 


00348 


00114 


00132 


00277 








.3 


00349 


00110 












.4 


00350 


00184 












#,40 


00326 














,4000 


00328 


00314 












#,6 


00351 














#A 


00323 














ARROW 


00332 


00229 












B 


00324 


00199 


00217 


00270 


00273 






C.02 


00191 


00008 


00175 


00236 


00237 


00288 


00292 


CLEAR 


00134 


00124 


00316 










D01 


00139 


00126 












D02 


00146 


00128 












D03 


00154 


00142 












D04 


00159 


00115 












D05 


00174 


00155 












D10 


00198 


00176 












Dll 


00241 


00209 












D12 


00248 


00212 
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DVR02 


CROSS-RFFERFNCE SYMBOL TABLE 




PAGE 00 


D14 


00262 


00258 










• EQTl 


00364 












EOT 10 


00373 


00146 


00159 








EQT11 


00374 


00162 


00282 








E0T12 


00375 
00242 


00140 
00263 


00151 


00161 


00205 


00214 


EQT13 


00376 


00154 


00167 


00211 


00223 


00241 


EQT14 


00377 


00170 


00183 


00252 


00256 




#EQT15 


00378 












•E0T16 


00379 












•EQT17 


00380 












• E0T2 


00365 












• EQT3 


00366 












EQT4 


00367 


00271 


00274 








EQT5 


00368 


00194 


00278 


00291 






• EGTfl 


00369 












• EQT7 


00370 












#EQT8 


00371 












E0T9 


00372 


00109 


00119 


00198 






1.02 


00105 


00008 


00113 


00133 


00180 


00185 


I. A. 4 


00182 


00178 










I. A, 6 


00184 


00135 










IEXIT 


00179 


00338 










IEXTA 


00338 


00174 










101 


00234 


00224 


00227 


00244 


00259 


00264 


102 


00235 


00312 










103 


00269 


00196 


00206 


00230 


00250 


00306 


104 


00286 


00315 










105 


00290 


00280 











00309 
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DVR02 CROSS-REFFRENCE SYMBOL TABLE PAGE 0003 



tIA 


00334 


00305 






LINF 


00354 


00152 


00255 




MASK1 


00356 


00122 






MASK2 


00358 


00272 






MASK3 


00357 


00220 






N100 


00339 


00139 






• N4 


00346 








RETN 


00331 


00253 


00254 


00257 


SETIO 


00304 


00107 


00193 


00318 


TEMPI 


00336 


00202 


00222 


00248 



PRIVILEGED INTERRUPT I/O DRIVERS 

Privileged interrupt I/O drivers include a third relocatable, closed subroutine in addition to the 
Initiation Section and the Completion Section. This subroutine is the Privileged Interrupt Section. 
P.nn is the entry point name. The Initiation Section is identical to those written for the standard 
I/O drivers except that the EQT entry should be saved for subsequent use by the Privileged Inter- 
rupt Section. Figure 13-3 is a flowchart of the privileged interrupt driver Initiation Section. 
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return 

to 

P+1 






(A) = 1 or 

2 reject 

codes 


NO 


* i 


L 


















(A) = 3, 
reject 
code 


NO 







( 


l.nn 


) 


V 


l/C 


configure 
) instructions 
for device 




initialize 

operating, 

conditions, 

flags, etc. 



save EOT 

entry for 

the Privileged 

Interrupt Section 



set buffer 

address, length, 

mode, etc. for 

transfer 



(activate ^ 
device J 



A register 
(A) = 4or0 



return to 
P+1 



Figure 13-3. Privileged Interrupt I/O Driver Initiation Section 
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Privileged Interrupt Section 

Control passes directly to the Privileged Interrupt Section of the driver (P.nrc) whenever an inter- 
rupt occurs from a device associated with the driver. The address specifying where control is to be 
passed (that is, the P.nn entry point) must be included at generation time while building the inter- 
rupt table entries (the ENT option should be used; see Section 10). Since control does not pass 
through the system's central interrupt routine before entering the Privileged Interrupt Section, the 
following standard interrupt processing is not performed : 

1. The I/O interface flag for the device is not cleared. 

2. The A register does not contain the interrupt source code. 

3. The EQT entry addresses are not set in the base page. 

Note: To allow access to the EQT entry, the Initiation Section should 
save the EQT address, then the Privileged Interrupt Section can 
use the saved address to reference the EQT entry. 



FUNCTIONS OF THE PRIVILEGED INTERRUPT SECTION: The Privileged Interrupt Section is 
responsible for the following functions (flowcharted in Figure 13-4): 

1. Upon entry to P.nrc, the driver must save the contents of the A, B, E, and O registers. 

2. The driver services the current data item and determines whether or not the transfer is 
complete. 

3. If the transfer is not complete, the Privileged Interrupt Section should set the device for the 
next transfer and proceed to step 5. 

4. If the transfer is complete, the Privileged Interrupt Section should make the following system 
completion call: 

EXT $PCOM 

LDA EQT1 (saved EQT entry) 

JSB $PCOM 

This call directs the system to pass control to the standard Completion Section (C.nn entry 
point) as soon as it is possible for a "system" device to interrupt. 

5. Prior to returning control to the point of suspension, the Privileged Interrupt Section must 
restore the A, B, E, and O registers. In addition, since memory protect is automatically dis- 
abled whenever an interrupt occurs, the Privileged Interrupt Section is responsible for restoring 
memory protect to its original state. A memory protect flag exists on the base page (MPTFL = 
271 8 ) to provide the driver with information concerning the state of memory protect. If 
MPTFL is zero, memory protect was on and an STC 5 instruction should be executed immedi- 
ately prior to returning to the point of suspension. If MPTFL is one, memory protect was off 
and an STC 5 instruction should not be issued. 
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Figure 13-4. Privileged Interrupt I/O Driver Privileged Interrupt Section 
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Privileged Interrupt Completion Section 

The completion section in a privileged interrupt driver is used to perform the following functions 
(flowcharted in Figure 13-5): 

1. Set the actual or simulated device status into bits through 7 of EQT word 4. 

2. Set the number of transmitted words or characters (depending on which the user requested) 
in the B register. 

3. Set the A register to indicate successful or unsuccessful completion. 

= successful completion 

1 = device malfunction or not ready 

2 = end-of-tape (information) 

3 = transmission parity error 

4. Clear the device control on end-of-operation, or set device for next transfer. 
Return to $CIC at P+l. 
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( C.nn J 



configure 

I/O instructions 

for device 



I 
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status in 
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Figure 13-5. Privileged Interrupt I/O Driver Completion Section 
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SAMPLE PRIVILEGED INTERRUPT I/O DRIVER 

The following pages provide an assembly listing and cross-reference symbol table for a sample 
privileged interrupt I/O driver. 



PAGE 0001 



0001 ASMB,P,B,L,C PRIVILEGED DRIVER FOR PUNCH 

** NO ERRORS* 
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PAGE 0002 #01 PRIVILEGED INTERRUPT PUNCH TAPE DRIVER-DVR02 



0001 

0003 

0004* 

0005 

0006* 

0007 

0008* 

0009* 

0010* 

0011* 

0012* 

0013* 

0014* 

0015* 

0016* 

0017* 

0016* 

0019* 

0020* 

0021* 

0022* 

0023* 

0024* 

0025* 

0026* 

0027* 

0028* 

0029* 

0030* 

0031* 

0032* 

0033* 

0034* 

0035* 

0036* 

0037* 

0036* 

0039* 

0040* 

0041* 

0042* 

0043* 

0044* 

0045* 

0046* 

0047* 

0048* 
0049* 
0050* 
0051* 
0052* 
0053* 
0054* 
0055* 
0056* 
0057* 



ASMS, R, 8, I, C PRIVILEGED DRIVER FOR PUNCH 
00000 NAM DVR02»0 

ENT I. 02, P, 02, C, 02 

EXT SPCOM,$MOVE 

***** PROGRAM DESCRIPTION ****** 

DRTVER 02 IS A SIMPLIFIED VERSION OF THE GENERAL PURPOSE 
PUNCH DRIVER TO ILLUSTRATE THE USE OF PRIVILEGED INTERRUPT 
FENCE REGISTER, 

DRIVER 02 OPERATES UNDER THE I/O CONTROL MODULE OF THE DOS 
EXECUTIVE FOR INITIATION AND COMPLETION AND DIRECTLY FROM THE 
TRAP CELL FOR PRIVILEGED INTERRUPTS, 

1.02 IS THE ENTRY POINT TO THE *INITIATI0N* SECTION 
P.02 IS THE ENTRY POINT TO THE *PRIVILEGED* SECTION 
C.02 IS THE ENTRY POINT TO THE *COMPLETION* SECTION 

- THE INITIATION SECTION IS CALLED FROM I/O CONTROL TO 
INITIALIZE A DEVICE AND INITIATE AN OUTPUT 

CALLING SEQUENCE! 

~ ADDRESSES OF DEVICE EQT ENTRY SET IN "EQT1-EQT17" 

(A) a I/O ADDRESS OF DEVICE 

(P) JSB 1,02 
(P+l) -RETURN- 

(A) * 0, OPERATION INITIATED 

» 4, OPERATION REJECTED-IMMEDIATE COMPLETIO 

- THE PRIVILEGED SECTION IS CALLED DIRECTLY FROM THE I/O TRAP 
CELL WHOSE ADDRESS HAS BEEN SET AT SYSTEM GENERATION, 

CALLING SEQUENCE! 

(P) JSB P.02 
(P*l) -RETURN- 

- THE COMPLETION SECTION IS CALLED BY CENTRAL INTERRUPT 
CONTROL TO COMPLETE AN OPERATION, 

CALLING SEQUENCE! 

- ADDRESSES OF DEVICE EQT ENTRY SET IN "EQT1-EQT17" 

(A) • I/O ADDRESS OF DEVICE 

(P) JSB C.02 
(P+l) -RETURN- 

(A) « 0, SUCCESSFUL COMPLETION 

• RECORD FORMAT MUST BE A STRING OF ASCII CHARACTERS 
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PAGE 0003 #01 INITIATOR SECTION 



0059* 

0060* 

0061* 

0062* 

0063* 

0064* 

0065* 

0066* 

0067* 

0068* 

0069* 

0070* 

0071* 

0072* 

0073* 

0074* 

0075 

0076 

0077 

0078 

0079 

0080 

0081 

0082 

0083 

0084 

0085 

0086 

0087 

0088 

0089 

0090 

0091 

0092 

0093 

0094 

0095 

0096 

0097 

0098 

0099 

0100 

0101 

0102 

0103 

0104 

0105 

0106 

0107 

0108 

0109 

0110 



THE FUNCTIONS OF THE INITIATION SECTION ARE* 

1. CONFIGURE I/O INSTRUCTIONS 

2. SAVE SYSTEM EOT ENTRY ADDRESSES USED IN PRIVILEGED 
SECTION FROM EQT1-EGT17. 

3. CHECK FOR LEGITIMATE REQUEST CODE 

4. FORM CHARACTER BUFFER ADDRESS 

5. FORM NEGATIVE CHARACTER COUNT 

6. OUTPUT FIRST CHARACTER 

7. ENABLE DEVICE 

8. RETURN 



00000 
00001 
00002 
00003 
00004 
00005 
00006 
00007 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00040 
00041 
00042 
00043 



note: 



FUNCTION 
STANDARD 



2 IS THE 

DRIVERS 



MAIN DIFFERENCE FROM 



000000 

016140R 

062160R 

066161R 

016002X 

000166R 

162175R 

002020 

003004 

050055 

002001 

026042R 

162177R 

001200 

172201R 

162200R 

002003 

026042R 

002020 

026026R 

001000 

003004 

172202R 

166177R 

136201R 

160001 

001727 

010074 

102600 

136202R 

000000 

1-02700 

002400 

126000R 

060057 

126000R 



1,02 



I.02A 



I.02B 



ERTN 



NOP 
JSB 
LDA 
LDB 
JSB 
DEF 
LDA 
SSA 

cma, 

CPA 

RSS 

JMP 

LDA 

RAL 

STA 

LDA 

SZA, 

JMP 

SSA 

JMP 

ALS 

CMA, 

STA 

LDB 

ISZ 

LDA 

ALF, 

AND 

OTA 

ISZ 

NOP 

STC 

CLA 

JMP 

LDA 

JMP 



CONFG 

DEGTl 

N17 

SMOVE 

TEQl 

TEQ8,I 

INA 



ERTN 
TEQ10,I 

TEQ12,I 
TEQ11,I 
RSS 
ERTN 

* + 3 

INA 

TEQ13,I 
TEQ10,I 
TEQ12,I 

B,I 
ALF 
,377 


TEQ13,I 



1.02,1 
.4 

1,02,1 



INITIATOR SECTION ENTRY 
CONFIGURE I/O INSTRUCITONS 
MOVE SYSTEM EQTl-EQTl7 INTO 
PRIVILEGED DRIVER EOT AREA 



GET REQUEST CODE 

MAKE * IF NEGATIVE 



IGNORE REQUEST CODE RETURN 
FORM CHARACTER BUFFER ADDRESS 

•BUF ADDR USED BY DRIVER- 
FORM NEGATIVE CHARACTERS COUNTER 



ERROR IF ZERO CHARACTER 



•CHAR COUNT USED BY DRIVER- 



FORM FIRST CHAARACTER 



output first character 
incr for first character 

ENABLE DEVICE 
INDICATE NORMAL RETURN 
RETURN TO SYSTEM 
IMMEDIATE COMPLETION RETURN 
RETURN TO SYSTEM 
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PAGE 0004 #01 PRIVILEGED SECTION 



0112* 

0113* 

0114* 

0115* 

0116* 

0117* 

0116* 

0119* 

0120* 

0121* 

0122* 

0123* 

0124* 

0125* 

0126* 

0127* 

0128* 

0129* 

0130* 

0131* 

0132* 

0133 

0134 

0135 

0136 

0137 

0138 

0139 

0140 

0141 

0U2 

0143 

0144 

0145 

0146 

0147 

0148 

0149 

0150 

0151 

0152 

0153 

0154 

0155 

0156 

0157 

0158 

0159 

0160 

0161 

0162 

0163 



PRIVILEGED PROCESSOR SECTION 



THE FUNCTIONS OF THE PRIVILEGED SECTION AREl 

1, TURN OFF INTERRUPTS 

2, SAVE COMPUTER REGISTERS AT INTERRUPT 

3, IF ALL CHARACTERS OUTPUT, GO TO FUNCTION 10 

4, OUTPUT NEXT CHARACTER 

5, ENABLE DEVICE 

6, RESTORE REGISTERS 

7, SET MEMORY PROTECT TO ORIGINAL STATE AT TIME OF INTERRU 

8, TURN ON INTERRUPTS 

9, RETURN TO POINT TO INTERRUPT 

10. CALL $PCOM TO ENTER DEVICE INTO PRIVILEGED INTERRUPT 
COMPLETION QUEUE 

11. DISABLE DEVICE 

12. RETURN TO POINT OF INTERRUPT 



00044 
00045 
00046 
00047 
00050 
00051 
00052 
00053 
00054 

00055 

00056 
00057 
00060 
00061 
00062 
00063 
00064 
00065 
00066 
00067 
00070 
00071 
00072 
00073 
00074 
00075 
00076 
QQQ77 
00100 
00101 
00102 



000000 

103100 

016120R 

162202R 

002003 

026077R 

166201R 

136201R 

004065 

160001 

002041 

001727 

010074 

102600 

103700 

136202R 

000000 

064271 

006002 

026074R 

016130R 

102100 

102705 

126044R 

016130R 

102100 

126044R 

062166R 

016001X 

106700 

026065R 



P. 02 



P.02A 
P,02B 



P.MPT 



MPOFF 

P.02D 
P.02E 



NOP 

CLF 

JSB 

LDA 

SZA, 

JMp 

LDB 

ISZ 

CLE, 

LDA 

SEZ, 

ALF, 

AND 

OTA 

STC 

ISZ 

MOP 

LDB 

SZB 

JMP 

JSB 

STF 

STC 

JMP 

JSB 

STF 

JMP 

LDA 

JSB 

CLC 

JMP 





SEOAB 

TEQ13,I 

RSS 

P.02D 

TEQ12, I 

TEQl2fI 

ERB 

B,I 

RSS 

ALF 

.377 



f C 

TEQ13, I 



TURN OFF INTERRUPT SYSTEM 
SAVE REGISTERS 
CHECK IF LAST CHARACTER SENT OUT 

YES, SO INITIATE COMPLETION PROC 

INCREMENT BUFFER ADDRESS 

PUT DATA IN A REGISTER 

CHECK IF UPPER OR LOWER CHARACTE 

UPPER SO MOVE INTO LOW 
MASK OFF OTHER CHARACTER 
OUTPUT A CHARACTER 
ENABLE DEVICE 
INCREMENT CHARACTER COUNT 



MPTFL CHECK IF MEM PROTECT TO BE ENABL 

YES 
MPOFF NO 

REOAB RESTORE REGISTERS 
TURN ON INTERRUPTS 

5 ENABLE MEMORY PROTECT 

P. 02, I RETURN TO POINT OF INTERRUPT 
REOAB RESTORE REGISTERS 
TURN ON INTERRUPTS 

P. 02, I RETURN TO POINT OF INTERRUPT 

TEQ1 CAUSE COMPLETION INTERRUPT 
SPCOM ENTER DEVICE INTO PRIV INT COMPLETIO 

CLEAR PEVICE 
P. MPT GO TO RETURN PROCESSOR 
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0165* 

0166* 

0167* 

0168* 

0169* 

0170* 

0171* 

0172* 

0173* 

0174* 

0175* 

0176 

0177 

0178 

0179 

0180 

0181 

0182 

0183 

0184 

0185 

0186 

0187 

0188 



COMPLETION PROCESSOR SECTION 



THE FUNCTIONS OF THE COMPLETION SECTION ARE* 

1. UPDATE STATUS IN EQT4 

2. SET TRANSMISSION LOG IN B 

3. CLEAR A TO INDICATE OKAY COMPLETION 

4. RETURN TO CENTRAL INTERRUPT PROCESSOR 



00103 
00104 
00105 
00106 
00107 
00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 



000000 
102500 
010071 

070001 

162171R 

010075 

030001 

172171R 

166200R 

006020 

007004 

002400 

126103R 



C.02 
C.02A 



NOP 

LIA 

AND 

STA 

LDA 

AND 

IOR 

STA 

LDB 

SSB 

CMB,INB 

CLA 

JMP C.02, I 




.37 

B 

TEQ4, I 

MASK2 

8 

TEQ4#I 

TEQ11,I 



UPDATE STATUS 



STATUS IN EGT4 
TRANSMISSION LOG IN B 



CLEAR A TO INDICATE QKAY STATUS 
RETURN TO SYSTEM 
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PAGE 0006 #01 SUBROUTINES 



0190* 


















0191* 


SAVE A,B,E 


:#o 












0192* 


















0193 


00120 


000000 


SE0A8 


NOP 










0194 


00121 


072207R 




STA 


XA 


A 






0195 


00122 


076210R 




STB 


XB 


B 






0196 


00123 


001520 




ERA, 


,ALS 








0197 


00124 


102201 




SOC 










0198 


00125 


002004 




INA 










0199 


00126 


072211R 




STA 


XEO 


E AND 






0200 


00127 


126120R 




JMP 


SE0A8,I 








0201* 


















0202* 


RESTORE A, 


B,E,0 












0203* 


















0204 


00130 


000000 


REOAB 


NOP 










0205 


00131 


062211R 




LDA 


XEO 


E AND 






0206 


00132 


103101 




CLO 










0207 


00133 


000036 




SUA, 


,ELA 








0208 


00134 


102101 




STF 


1 








0209 


00135 


062207R 




LDA 


XA 


A 






0210 


00136 


066210R 




LDB 


XB 


B 






0211 


00137 


126130R 




JMP 


REOAB,! 








0212* 


















0213* 


CONFIGURE 


I/O INSTRUCTIONS 








0214* 


















0215 


00140 


000000 


CQNFG 


NOP 










0216 


00141 


070001 




STA 


B 


SAVE SELECT CODE 


0217 


00142 


032162R 




IOR 


OTAC 








0218 


00143 


072034R 




STA 


I.02A 


CONFIGURE 


OTA 


SC 


0219 


00144 


072061R 




STA 


P.02A 








0220 


00145 


062163R 




LDA 


STCC 








0221 


00146 


030001 




IOR 


B 








0222 


00147 


072037R 




STA 


I.02B 


CONFIGURE 


STC 


SC 


0223 


00150 


072062R 




STA 


P.02B 








0224 


00151 


062164R 




LDA 


CLCC 








0225 


00152 


030001 




IOR 


B 








0226 


00153 


072101R 




STA 


P.02E 


CONFIGURE 


CLC 


SC 


0227 


00154 


062165R 




LDA 


LIAC 








0228 


00155 


030001 




IOR 


B 








0229 


00156 


072104R 




STA 


C.02* 


CONFIGURE 


LIA 


8C 


0230 


00157 


126140R 




JMP 


CONFG,! 


RETURN 
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PAGE 0007 *01 BUFFERS, POINTERS, CONSTANTS, AND MASKS 



0232* 

0233 

0234* 

023b 

0236 

0237 

0238 

0239 

0240 

0241* 

0242 

0243 

0244 

0245* 

0246 

0247* 

0248 

0249 

0250 

0251 

0252 

0253* 

0254 

0255 

0256 

0257 

0258 

0259 

0260 

0261 

0262 

0263 

0264 

0265 

0266 

0267 

0268 

0269 

0270 

0271* 

0272 

0273 

0274 

0275 

** NO 



00001 

00053 
00055 
00057 
00071 

00075 

00100 
00203 
00271 



ECU 1 



• • 

,2 

,4 

,37 

,377 

MASK2 



FQU 
FQU 
EQU 
EQU 
FQU 
EQU 



EQU 
EQT1 EQU 
MPTFL EQU 



53B 
..♦2 

,.♦4 
., + 14 
..♦17 
.. + 18 

100B 
, + 67 
. + 121 



00160 000203 OEQT1 OEF EQT1 



00161 
00162 
00163 
00164 
00165 

00166 
00167 
00170 
00171 
00172 
00173 
00174 
00175 
00176 
00177 
00200 
00201 
00202 
00203 
00204 
00205 
00206 



177757 

102600 
103700 
106700 
102500 

000000 
000000 
000000 

000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



00207 000000 

00210 000000 

00211 000000 

ERRORS* 



N17 

OTAC 

STCC 

CLCC 

UAC 

TEQ1 

TEQ2 

TEQ3 

TEQ4 

TEQ5 

TEQ6 

TEQ7 

TEQ8 

TEQ9 

TEQ10 

TEQ11 

TEQ12 

TEQ13 

TEQ14 

TEQ15 

TEQ16 

TEQ17 

XA 
XB 
XEO 



DEC -17 
OTA 
STC 0,C 
CLC 
LIA 

NOP 
NOP 
NOP 
MOP 
NOP 
NOP 
NOP 
NOP 
NOP 
NOP 
NOP 
NOP 
NOP 
NOP 
NOP 
NOP 
NOP 

NOP 
NOP 
NOP 
END 



DEC 2 
DEC 4 
OCT 37 
OCT 377 
OCT 177400 



EQUIPMENT TABLE ADDRESS 
MEMORY PROTECT FLAG 



INITIATION ADDRESS 
COMPLETION ADDRESS 
0,R, UNIT, CHANNEL 
AV, TYPE, STATUS 



REQUEST RETURN 

REQUEST CODE 

I/O REQUEST CONTROL WORD 

REQUEST BUFFER ADDRESS 

REQUEST BUFFER LENGTH 



A REGISTER TEMPORARY 
B REGISTER TEMPORARY 
E AND REGISTER TEMPORARY 
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DVR02 



CROSS-REFERENCE SYMBOL TABLE 



PAGE 0001 



SMOVE 


00007 


00079 








SPCOM 


00007 


00161 










00242 


00243 


00244 






* • 


00235 


00236 


00237 


00238 


00239 


,2 


00236 


00084 








,37 


00238 


00178 








.377 


00239 


00102 


00145 






,4 


00237 


00109 








B 


00233 
00225 


00100 

00228 


00142 


00179 


00182 


C.02 


00176 


00005 


00188 






C.02A 


00177 


00229 








CLCC 


00251 


00224 








CONFG 


00215 


00076 


00230 






DEQTl 


00246 


00077 








EQT1 


00243 


00246 








ERTN 


00109 


00086 


00092 






1.02 


00075 


00005 


00108 


00110 




I.02A 


00103 


00216 








I.02B 


00106 


00222 








LIAC 


00252 


00227 








MASK2 


00240 


00181 








MPOFF 


00157 


00152 








MPTFL 


00244 


00150 








N17 


00248 


00078 








OTAC 


00249 


00217 








P.02 


00133 


00005 


00156 


00159 




P.02A 


00146 


00219 




L3-33 





00240 



00216 



00221 



DVR02 


CROSS-REFERENCE SYMBOL TABLE 


P t 028 


00147 


00223 






P.02D 


00160 


00138 






P,02E 


00162 


00226 






P.MPT 


00150 


00163 






REOAB 


00204 


00153 


00157 


00211 


SE0A8 


00193 


00135 


00200 




STCC 


00250 


00220 






TEOl 


00254 


00080 


00160 




TEQ18 


00263 


00087 


00098 




TEQ11 


00264 


00090 


00184 




TEQ12 


00265 


00089 


00099 


00139 00140 


TEQ13 


00266 


00097 


00104 


00136 00148 


•TEQ14 


00267 








•TEQ1S 


00268 








#TEG16 


00269 








•TEQ17 


00270 








• TEQ2 


00255 








• TEQ3 


00256 








TEQ4 


00257 


00180 


00183 




• TEQ5 


00258 








#TEQ6 


00259 








#TEQ7 


00260 








TEQ8 


00261 


00081 






• TEQ9 


00262 








XA 


00272 


00194 


00209 




XB 


00273 


00195 


00210 




XEO 


00274 


00199 


00205 
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SECTION XIV 
Privileged Mode 



Certain situations may arise where a user wishes to process his own errors instead of having the 
operating system handle them for him. In addition, there may be cases where he wishes to determine 
when an I/O operation (initiated without wait) is complete. 

Both of these options are available with use of the system's privileged mode flag (MDFLG = location 
133 g ). In order to operate in this privileged mode (i.e., user processing of I/O errors and/or deter- 
mining I/O completions) the user 

• must be programming in Assembly language 

• is responsible for setting MDFLG properly 

Bit set - user error processing 

Bit 15 set - I/O completion processing 

DOS-Ill uses MDFLG as follows: 

1. After an I/O initiation (performed by an EXEC call) MDFLG bit is checked, and if it is 
equal to one, control returns to the user program with the A register set as follows: 

Contents (decimal) Meaning 

Operation initiated 

1 Read or write illegal 

2 Control request ignored 

3 Device down 

4 Immediate completion 

5 DMA busy 

6 Driver busy 

7 Driver overlay area busy 

8 EXEC overlay area busy 

9 Operation rejected 

10 Memory protect error 

11 Request code error 

12 Execution time exceeded 

13 Spare 
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Contents (decimal) Meaning 

14 Illegal logical unit 

15 Unassigned logical unit 

16 Illegal buffer address 

17 Memory wrap around 

18 Illegal track address 

19 File cannot be found 



2. After an I/O completion, MDFLG bit 15 is checked, and if it is equal to one, control is passed 
to a user subroutine which must immediately follow the EXEC call. Upon entry to the routine, 
the B register contains the driver transmission log and the A register contains the device status 
as follows: 

A register Contents Meaning 

I/O completed without errors 

-1 Device was not ready 

-2 End-of-tape 

-3 Parity error 

-4 Batch input detected a colon ( : ) 

If the I/O completion resulted from an I/O error (not ready, parity, or end-of-tape) and the 
device is not the system console or the disc, bit 14 of EQT4 (the fourth word of the current 
Equipment Table entry) is set to indicate that the device is down. 

MDFLG bit is then checked, and if it is equal to one, control returns to user (thus bypassing 
system processing of the error). 

3. During a FILE NAME SEARCH EXEC call (RCODE = 18) where the search is requested with- 
out wait, no subsequent EXEC calls are allowed- If a second EXEC call is requested during 
execution of a file search, the system will wait for the search to complete before processing the 
second EXEC call. If the user does not want the system to wait, he should set Bit 1 of MDFLG. 
If Bit 1 of MDFLG is set and the above condition is encountered, control will be returned to the 
user following the second EXEC call with the A register = 8 (EXEC busy). 

4. The system clears all bits of MDFLG following any program completion. 
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5. An I/O calling sequence operating in privileged mode might look something like this: 



END 
COMP 



JSB 


EXEC 


DEF 


END 


DEF 


RCODE 


DEF 


CONWD 


JMP 


INIT 



JMP COMP, I 



(must be an I/O without wait) 



If present, the completion routine must be located here. 
Executed following I/O completion, and should include 
a check for completion errors. This routine must not 
use any routine that is not re-entrant. 



INIT 



Executed following an I/O initiation, and should 
include a check for initiation errors. 
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PART 5 
Error Codes and Messages 



SECTION XV 
Halt Codes and Error Messages 



This section describes the error conditions which can occur while DOS-Ill is being generated, loaded 
and operated. Error conditions are reported to the user by one of the following: 

• a computer halt; the halt code is displayed in the DISPLAY register 

• an error message; the message is displayed on the system console 

• an error message (displayed on the system console) followed by a computer halt (halt code 
displayed in the DISPLAY register) 

• an error code returned to a user program (by EFMP); the error code is also returned in the 
A register 

This section contains halt code and error message tables, including corrective action (when applicable) 
for the following: 

• DSGEN ERROR CONDITIONS 

DSGEN Error Halts 
DSGEN Error Messages 

• DOS-Ill BOOTSTRAP ERROR HALTS 

• DOS-Ill ERROR CONDITIONS 

DOS-Ill Error Halts 
DOS-Ill Error Messages 

• EFMP ERROR CODES 



Note: The ALGOL, FORTRAN and Assembler subsystems also print error 
messages. These subsystem error messages are documented in the 
SOFTWARE OPERATING PROCEDURE module "Assembler, 
FORTRAN and ALGOL Error Messages" (5951-1377). FORTRAN IV 
error messages are described in HP FORTRAN IV (5951-1321). 
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Table 15-1. DSGEN Error Conditions 



DSGEN ERROR HALTS 



Halt Code Cause 

102000 Follows an irrecoverable error message. 

Generator unable to find $STRT in DISCM. 
DISCM is probably missing. 



Recovery Action 



102002 


Follows ERR02. 


102003 


Follows ERR03. 


102004 


Follows ERR04. 


102007 


Normal halt. Disc 



102022 



102032 



102077 



102000 



channel has completed. 

Disc error after ten attempts. Disc address 
in A, disc status in B. 



Disc not ready or disc should be unprotected. 
Disc address in A and disc status in B. 

Normal halt. 

Ready to receive another program tape. 



If DSGEN is above 10000 8 an impossible 
condition has occurred. 



Irrecoverable 
Irrecoverable 



See ERR02 in error messages. 

See ERR03 in error messages. 

See ERR04 in error messages. 

Start the computer executing to initialize 
another subchannel or to generate a system. 

Start execution to retry ten more times. 
When preceded by ERR 12 continues to 
next track. 

Ready or unprotect the disc. Start the 
computer executing. 

Continue generation. 

Enter next tape and start the computer 

executing. 

Either a hardware/software failure has 
occurred or DSGEN has overflowed its 
work area because the system was too 
large. 



DSGEN ERROR MESSAGES 



Messages During Initialization and Input Phases 



Message Meaning 

ERR01 Invalid response to initialization request. 

ERR02 Checksum error on program input. 

ERR03 Record out of sequence. 



Action 

Request is repeated. Enter valid reply. 

Computer halts; to try again, reposition 
tape to beginning of program and start 
the computer. 

SameasERR02. 
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Table 15-1. DSGEN Error Conditions (continued) 



Message 



Meaning 



Action 



ERR04 



Illegal record type. 



Same as ERR02. If input is from disc, error 
is irrecoverable; remove non-relocatable files 
from disc. 



ERR05 
name 



Duplicate entry point. 



The current entry point replaces the previous 
entry point. 



ERR06 



ERR07 



ERR08 
name 



Invalid base page length in BCS-produced 
relocatable tape (must be zero). 

Program name or entry point table over- 
flow of available memory. 

Duplicate program name. 



Base page area is ignored, but memory pro- 
tect error will occur if program is executed. 

Irrecoverable error. Revise or delete 
programs. 

The current program replaces the previous 
program. 



Messages During the Parameter Phase 

ERR09 Parameter name error (no such program) 

ERR10 Parameter type error. 



Enter valid parameter statement. 
Same as ERR09. 



General Messages 

ERR1 1 System directory track overflow. 



ERR12 

ERR13 

ERR14 



ERR15 



Disc error during disc initialization. 



User segment precedes user main program. 

Absolute code overlays relocatable code 
in the disc scratch area. 



More than 63 subprograms called by a 
main program. 



Irrecoverable. Regenerate system and reduce 
the value of the response to the "FIRST 
SYSTEM SECTOR?" message. 

Start the computer executing to bypass the 
faulty tracks. 

Irrecoverable. 

Irrecoverable. Regenerate the system and 
select one of the following two options: 

1. Reduce number of programs being loaded 

2. Load the library after all other programs 
are loaded. If this is not successful, in- 
crease the size of the system disc and/or 
lower the starting track/sector of the 
system. 

Revise main program (subsequent calls to 
subprograms are ignored). 
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Table 15-1. DSGEN Error Conditions (continued) 



Message 



Meaning 



Action 



ERR16 

ERR17 
ERR18 

ERR19 
ERR20 

ERR21 
ERR22 

ERR23 



Base page linkage overflow. 



Current disc address exceeds number of 
available tracks. 

Memory overflow (absolute code exceeds 
LWA memory). 



Program overlay (current word of absolute 
code has identical location to previous word). 

Binary DBL record overflow of internal 
table. 



Module containing entry point $CIC not 
loaded. 

Read parity/decode disc error. A register 
bits 8-14 show track number; bits 0-7 
show sector number. 

EQT not entered for disc-resident I/O 
module. 



Diagnostic printed once when overflow 
occurs. Bounds field indicates the number 
of words overflowed. Revise order and 
composition of program loading to reduce 
linkage requirements. 

Irrecoverable error. 



Diagnostic printed once when overflow 
occurs. Bounds field indicates the number 
of words overflowed. (Absolute code is 
generated beyond LWA). Revise program. 

Current word is ignored (the address is 
printed). 

Records overlay previous DBL records 
(diagnostic printed for each overflow 
record). Revise program. 

Irrecoverable error. Regenerate the system; 
include DISCM. 

After ten attempts to read or write the disc 
sector, the computer halts. To try ten more 
times, start the computer executing. 



Restart at 100 8 . 



Messages During I/O Table Entry 

ERR24 Invalid channel number. 

ERR25 Invalid driver name or no driver entry points. 

ERR26 Invalid or duplicate D,R,U operands. 

ERR27 Invalid logical unit number. 

ERR28 Invalid channel number. 

ERR29 Channel number decreasing. 

ERR30 Invalid INT mnemonic. 

ERR31 Invalid EQT number. 

ERR33 Invalid entry point. 

ERR34 Invalid absolute value. 

ERR35 Base page interrupt locations overflow into 
linkage area. 

ERR36 Invalid number of characters in final operand. 



Enter valid EQT statement. 

Same as ERR24. 

Same as ERR24. 

Enter valid DRT statement. 

Enter valid INT statement. 

Same as ERR28. 

Same as ERR28. 

Same as ERR28. 

Same as ERR28. 

Same as ERR28. 

Restart Disc Loading Phase. 

Same as ERR28. 
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Table 15-2. DOS-Ill Bootstrap Error Halts 



Halt Code 



Cause 



Recovery Action 



10201 1 Disc error status is in the A register. If 

A register contains 0, the subchannel did 
not contain a system. 



Check that the device is ready and the 
proper disc cartridge is being used; then 
call maintenance. 



102031 



Same as above. 



Occurs during execution of disc-resident 
part of Bootstrap. Check that the disc is 
ready; then call maintenance. 
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Table 15-3. DOS-Ill Error Conditions 



DOS-Ill ERROR HALTS 



Halt Code 



Location 



102002 location 2 8 

102003 location 3 8 



1 02004 



102005 



DISCM 



DISCM 



102011 $EX20 



102031 DVR31 



102077 $EX20 



Cause 

Possible memory wrap-around when 
memory protect is not present. 

Power has gone up or down with 
powerfail option present. 

Memory parity error occurred. 



Disc parity error. Halt occurs after 
a message is printed giving location 
of error. 

Trying to write on disc cylinder that 
is flagged "protected" without first 
unprotecting the disc. 

Follows message telling operator to 
protect the disc after spare track 
assignment. 



Recovery Action 

Program error. Bootstrap DOS-Ill from 
the disc and correct the program. 

Bootstrap DOS-Ill from disc and restart. 



A-register contains address of word con- 
taining the parity error. Run the memory 
diagnostic programs, then bootstrap 
DOS-Ill from disc and restart. 

Unprotect the disc and start the com- 
puter executing. DOS-Ill assigns next 
spare track. 

Start the computer executing to exit 
DVR31 with no action taken. 



Protect the disc and start the computer 
executing. DOS-Ill aborts the job that 
was running. 



DOS-Ill ERROR MESSAGES 

During the operation of DOS-Ill certain messages may be output on the system console. These messages may be 
error reports or simply informative; they are generated by various parts of DOS-Ill. The messages are listed alpha- 
betically including where they originated, what they mean, and what response if any, the operator must make. 
Messages that begin with a variable name or a non-alphabetic character are listed by the first non-variable, alphabetic 
character. 



Message 
BAD CONTROL STATE 



Source Description 

JOBPR Directive just entered is not acceptable in DOS III. Enter 

correct directive on system console. 



BEGIN 'DEBUG' OPERATION 



DEBUG Any legal DEBUG operations may now be entered. Enter 

any legal DEBUG operations. 



BP BND [L,U]? 



LOADR Specify the base page bounds desired for the program being 

loaded by the Loader. The bounds should be entered as two 
octal constants separated by a comma. 



CHECKSUM ERROR 



JOBPR Checksum error in input to ST,R,file or ST,X,file directive. 

Correct tape. 



This error causes a batch abort if the command is entered in batch mode. See "Batch Abort" in Section 1. 
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Table 15-3. DOS-Ill Error Conditions (continued) 



Message 



Source 



Description 



CW nnnnn 



DEVICE #nn DOWN 



DISCM In an I/O READ/WRITE EXEC call at nnnnn, buffer extends 

beyond memory bounds. Correct program. 

JOBPR EOT #nn is unavailable (down). Use the UP,nn directive to 

make the device available. (Then use the GO directive if 
needed.) 



DICTIONARY OVERFLOW 



JOBPR No room is left for entries in the user file dictionary. Put file 

on another disc or remove some of the files. 



??? DISC 



DISCM Informs user that disc is not recognizable by DOS-Ill. Must 

be labeled or unlabeled with :IN, or formatted with DSGEN, 
before using in DOS-Ill. 



DISC GEN CODE nnnn NOT SYS GEN CODE mmmm ERR POSS 



DISCM Informs the user that the disc being requested was initialized 

(labeled) by a system with a different system generation 
code. Generation code on disc may be updated by labeling or 
unlabeling using :IN. 



DISC NOT ON SYSTEM 



DISCM No disc pack with the currently requested label can be found 

on the system. Mount disc pack with correct label or ready 
drive containing disc. 



DONE? 



JOBPR Thirty feed frames (paper tape) or an end-of-file (magnetic 

tape) have occurred during input. Enter YES for end of input; 
NO for more input. 



??? LABEL xxxxxx 
DOS LABEL xxxxxx 
TSB LABEL xxxxxx 
OK TO PURGE? 



DISCM Attempting to label (or unlabel) an already labeled disc pack. 

Enter YES to relabel the disc pack or NO to drop the request 
to relabel the disc pack. 



DUPLICATE FILENAME 



JOBPR Doubly defined file name found in a STORE directive (other 

than STORE,P);an EDIT directive with a new file name; 
on DD,U; or on a RENAME directive. Remove file or rename 
file. 1 



$END ALGOL 
SEND ASMB 
$ENDASMBCS 



ALGOL End of ALGOL compilation. No response required. 

ASMB Assembly has completed. No response required. 

ASMB Assembly has ended because of an error in the assembler 

control statement. Correct the control statement. 



SEND ASMB NPRG 



ASMB Assembly has terminated because no JFI LE was found when 

required. Define the file using a JFILE directive. 



This error causes a batch abort if the command is entered in batch mode. See "Batch Abort" in Section 1 . 
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Table 15-3. DOS-Ill Error Conditions (continued) 



Message 



Source 



Description 



$ENDASMBPASS 



ASMB Another pass of the source program through the input device 

is required. Printed on the system console after Pass 1 . Replace 
the program in the input device and type :GO. 



$END ASMB XEND 



END FILE 



$END,FTN[4] 



ASMB Assembly stops. An EOF occurred in the source program 

before an END statement. Add an END statement to the 
program. 

JOBPR During an EDIT, (1) the master file ended before completion 

of editing or (2) a triple colon occurred in the first 3 columns 
of a source statement. Check input to the EDIT program. 1 

FTN [4] Compilation has completed. No response required. 



END JOB xxxx [RUN = xxxx MIN. xx.x SEC EXEC = xxxx MIN. xx.x SEC] 



ENTER FILE NAME(S) OR /E 

ENTRY ERROR 
EOF-NO DATA STORED 



JOBPR End of current job. Total job time and execution time of the 

job are printed on the system console and standard list device 
if a Time-base Generator is present. 

LOADR Enter list of relocatable program files. To terminate list of 

file names type "IE". 

DEBUG DEBUG operation entered was illegal. Correct entry. 

JOBPR An attempt was made to read an EOF without first reading 

data. A file is not created when this message is output. 



EQTxxCHxx DVRxx D R UxSx JOBPR 
EXTRA PARAMETERS 



Equipment table entry output by the EQ directive. No action 
required. 



JOBPR More than 15 parameters in a directive. Excess parameters are 

not processed. 

Fl nnnnn DISCM In a FILE READ/WRITE EXEC call (1) the file requested at 

nnnnn cannot be found. If nnnnn is not present, enter the file. 
(2) The length of the buffer requested at nnnnn extends be- 
yond the end of the file. Correct the buffer length. Either 
case causes calling program to abort. 

HPAL?? ALGOL Control statement error. Correct control statement. 

IB nnnnn DISCM Illegal buffer address in EXEC call at location nnnnn. Program 

is aborted. Correct buffer program address. 

IE nnnnn DISCM If a colon occurs in the first column of input entered through 

the batch device during a program execution, the program is 
aborted, control is given to the JOBPR and the input is pro- 
cessed as a directive, nnnnn is the memory location of the 
input request. 



This error causes a batch abort if the command is entered in batch mode. See "Batch Abort" in Section 1. 
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Table 15-3. DOS-Ill Error Conditions (continued) 



Message 



Source 



Description 



IGNORED 



DISCM Input from system console during program execution cannot 

be processed. Correct input. 



'IGNORED 



JOBPR All directives following EJOB and before next JOB except 

BATCH, TYPE, TRACKS, and OFF are ignored. Enter 
acceptable directive. 



file 
ILLEGAL 

ILLEGAL DIGIT 



JOBPR On a source file LIST directive, the requested file was not a 

source file. Retype LIST directive using source file. 1 
A file name begins with a non-alphabetic character. Rename the file. 

JOBPR In a decimal number, character is other than 0-9. Enter correct 

decimal number. In an octal number, digit is other than 0-7. 
Enter correct octal number. 1 



ILLEGAL LUN 



JOBPR Logical unit requested is equal to zero, greater than the number 

of logical units in the system, not the correct type (i.e., input 
type for output device), etc. Enter a correct logical unit. 1 



ILLEGAL PROGRAM RUN LIMITS 



DISCM Attempt to run a user main or segment whose user area 

limits or base page limits will not fit within the limits of the 
current system. Recreate user mains or segments on current 
system using LOADR. 



ILLEGAL PROGRAM TYPE 



INPUT ERROR 



JOBPR 



DISCM 



Program requested in a RUN or PROG is not legal. Enter 
correct name. 1 

Equipment table entry number or logical unit number in :EQ, 
:LU, :UP or :DN is illegal. Enter correct equipment table or 
logical unit entry number. 



INPUT :DATE, XXXXXXXXXX[,H,M] 

DISCM 



When system is initiated from the disc, DOS-Ill requires a 
DATE directive. The [,H,M] is ignored in DOS-Ill if a Time- 
base Generator is not in the system. Enter a DATE directive.- 



I/O ERR ET EQT#mm 



DISCM End-of-tape on device #mm. EOT #mm is unavailable. To 

make the device available (up), use the UP, mm directive. 



I/O ERR NR EQT#mm 



DISCM The device #mm is not ready. To make the device available 

(up), use the UP, mm directive. 



I/O ERR PE EOT mm 



DISCM Parity error on device #mm returns to program return 

address with A set to status, B set to 0. Call maintenance. 



This error causes a batch abort if the command is entered in batch mode. See " Batch Abort" in Section 1 . 
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Table 15-3. DOS-Ill Error Conditions (continued) 



Message 



Source 



Description 



I/O ERR < P ^_ > USER DISC DISGM 



I/O ERR1 ^ >USF.R DISK 



IT nnnnn 



JBIN OVF 



JOB ABORTED! 



DISCM 



DISCM 



FTN [,4], 

ASMB, 

ALGOL 

JOBPR 



JOB xxxxx dddddddddd [TIME = xxxx MIN. xx. 

JOBPR 



L01 
L02 
L03 

L04 
L05 
L06 

L07 
L08 
L09 
L10 
L11 
L12 
L13 



LOADR 
LOADR 
LOADR 
LOADR 
LOADR 
LOADR 

LOADR 
LOADR 
LOADR 
LOADR 
LOADR 
LOADR 
LOADR 



A parity error or device not ready occurred when attempting 
to assign a user disc. Disc may not be formatted; format it 
with DSGEN. 



Disc error in completion section of DVR31. Retry previous 
operation. 

Illegal disc track or sector address in EXEC call from location 
nnnnn. Program is aborted. Correct the track or sector 
address in EXEC call. 

Overflow of Job Binary Area during assembly or compilation. 
Reduce size of job or purge user files. 



Correct problem and start new job. 

x SECS EXEC = xxxx MIN. xx.x SEC] 

Message output at the beginning of each job. The time infor- 
mation is deleted in DOS-Ill if a Time-base Generator is not 
included in the system. Start job. 

Checksum error on tape. 

Illegal record. 

Memory overflow. 

Base page overflow. 

Symbol table overflow. 

Duplicate main or segment name (may be caused by attempt- 
ing to run the Loader twice in one job). 

Duplicate entry point. 

No main or segment transfer address. 

Record out of sequence. 

Insufficient directory work area or user area space. 

Program table overflow. 

User file specified cannot be found. 

Program name duplication. 
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Table 15-3. DOS-Ill Error Conditions (continued) 



Message 



Source 



Description 



L14 
L15 
L16 
L17 
L18 



L19 



LBL= 111111 



LIMIT ERROR 



xxxx LINES 

****LISTEND**** 

LN nnnn 

LOADR COMPLETE 
LOADR SUSP 

LOADR TERMINATED 
LOAD TAPE 



LOADR Non-zero base page length. 

LOADR Segment occurred before main. 

LOADR Program overlay (illegal ORG). 

LOADR Illegal library record. 

LOADR Illegal octal digit in base page bounds specification; or the 

lower base page bound is greater than the upper base page 
bound; or the lower or upper base page bound is greater than 
2000 8 . In keyboard mode, re-enter new base page bounds. 
In batch mode, Loader aborts. 

LOADR Illegal octal digit in main memory bounds specification; or 

the lower program bound is greater than the upper program 
bound. In keyboard mode, re-enter new program bounds. In 
batch mode. Loader aborts. 

DISCM Disc subchannel referenced is labeled 111111. If attempting 

to change user disc subchannel, enter :UD with correct label. 

JOBPR In a directive, source statement numbers are out of order 

(:EDIT), dump limits are incompatible (:PDUMP, :ADUMP), 
sector numbers are illegal (:DUMP), number of words re- 
quested exceeds number of words available (:MMGT), or 
beginning source statement number is greater than final 
statement number (:EDIT). Correct directive and re-enter. 1 

JOBPR Total number of statements stored by a STORE,S directive. 

No response required. 

JOBPR Terminates list of source statements generated by a LIST 

directive. No response required. 

DISCM Logical unit requested by an EXEC call at nnnnn is unassigned. 

Program is aborted. Assign logical unit. 

LOADR Loading has completed. No responses required. 

LOADR Loader has suspended (usually at EOT). Type :GO,n to 

restart the Loader with proper parameter value. 

LOADR Loader has terminated because of an error. Correct input. 

LOADR In conjunction with LOADR SUSP, this message requests that 

next relocatable tape be loaded before :GO. Load the next 
relocatable tape and enter :GO to read next tape or :GO,1 
to indicate that all tapes are read in. 



This error causes a batch abort if the command is entered in batch mode. See "Batch Abort" in Section 1. 
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Table 15-3. DOS-Ill Error Conditions (continued) 



Message 



Source 



Description 



LU nnnnn 



DISCM Illegal logical unit in EXEC call at nnnnn. Program is aborted. 

Enter correct logical unit number. 



LUxx EQTyy 



JOBPR Logical unit table entry; EQT #yy assigned to LU #xx. No 

response required. 



LUN UNASSIGNED 



JOBPR Logical unit requested in a directive is unassigned. Assign 

logical unit number requested in the directive. 1 



xxxxx MISSING 



DISCM Segment xxxxx requested by an EXEC call is not in system 

or user directory. Job is aborted. Correct job. 



MISSING PARAMETER 



JOBPR A parameter is missing in a directive. Retype the directive 

correctly. 1 



MP nnnnn 



DISCM Memory protect violation at location nnnnn. Program is 

aborted. Correct the program. 



NAME 'IGNORED 



JOBPR Illegal JOB name; numeric first character. Retype correct 

job name. 



NEXT AVAIL TRACK=tt 
BAD=n 



JOBPR In TRACK directive, tt = first track beyond end of current 

user area; n = number of bad tracks. "BAD=n" returned only 
if bad tracks do exist, tt = "NONE" if no tracks are available. 



NO BIN END 



JOBPR No END record detected when storing a relocatable binary 

program. 1 



NO PROGRAMS LOADED 


LOADR 


NO SOURCE 


JOBPR 


NO SOURCE 


ALGOL 


NO SUBSYSTEMS DEFINED 


JOBPR 


NUMBER OVERFLO 


JOBPR 


OR nnnnn 


DISCM 



OVERFLOW JBIN 



JOBPR 



No programs were loaded by the Loader. Loading terminates. 

No source statements following a /R or /I in an EDIT 
directive. Enter source statements after the /R or /I. 1 

Source file from disc not pre-set. 

Informs the user that a :MM directive was attempted but no 
subsystems were defined during system generation. 

An integer is too large. 1 

I/O operation requested by EXEC call at nnnnn is rejected. 
Program is aborted. Check program. 

There is not enough room in the JBIN for storing the re- 
locatable binary output from the Assembler or compilers. 1 



PARAMETER ILLEGAL 



JOBPR 



A parameter of a directive is illegal. Re-enter directive. 



PARITY ERROR 
SC=m,TRK=ttt,SCTR=sss 



JOBPR 



Parity error during disc read or write. Call maintenance. 



Thi9 error causes a batch abort if the command is entered in batch mode. See "Batch Abort" in Section 1 . 
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Table 15-3. DOS-Ill Error Conditions (continued) 



Message 



Source 



Description 



PAUSE xxxx 



LI BR Program has temporarily suspended itself, xxxx is an octal 

(Formatter) number acting as an identifier. Restart program using the GO 
directive. 



PROG BND [L,U]? 



LOADR Enter the program bounds for the program being loaded by 

the Loader. The bounds consist of two octal numbers 
separated by a comma. 



RE-ENTER STATEMENT ON TTY 



JOBPR Follows most error messages that do not cause abort. Type 

in the correct statement. 



RQ nnnnn 



DISCM Illegal parameter in EXEC call at nnnnn. Program is 

aborted. Correct the program. 



SPARE TRK OVERFLOW 



JOBPR Defective cylinder detected and no spare tracks available for 

reassignment. 



STOP xxxxx: nnnnn 
SUBCHAN = n 



LI BR Program xxxxx has terminated at location nnnnn. 

DISCM/ Given in response to :UD information request or when :SS 

JOBPR makes new subchannel assignment. No response required. 



xxxxx SUSP 



DISCM Program xxxxx suspended by EXEC call or PAUSE directive. 

Restart program using the GO directive. 



TAPE END 



JOBPR EOT flag set on magnetic tape or paper tape device during 

output via JOBPR directives DUMP and LIST or output 
of a JOB or EJOB statement. If a magnetic tape, it is rewound 
with standby; if paper tape, a trailer is punched. The JOBPR 
will then pause to allow new tape to be set up. Mount a new 
magnetic tape. Enter :GO to continue the output. 



TM nnnnn 



DISCM Maximum execution time exceeded. The program is currently 

at nnnnn and is aborted. Increase execution time. 



#TRACKS UNAVAILABLE 



TRAC#TOOBIG 



DISCM There are not enough word tracks for the compiler. Enter 

:OFF then purge disc of unnecessary files. 

JOBPR Track requested is higher than last available disc track (track 

may be in JBIN area). Redefine the track request or purge 
files or use different disc. 1 



TSB DISC 



DISCM Informs user that the user disc was labeled by a non-DOS-lll 

system. May be made DOS-Ill disc by labeling or unlabeling 
with :IN. 



1 

This error causes a batch abort if the command is entered in batch mode. See "Batch Abort" in Section 1. 



15-13 



Table 15-3. DOS-Ill Error Conditions (continued) 



Message 



Source 



Description 



TURN 




DISC PROTECT OVERRIDE SWITCH 

DISCM Unprotect [ON] or protect [OFF] the disc. 



UD nnnnn 



DISCM Unable to find user disc requested by EXEC call at nnnnn. 

Mount required disc and type :GO; or terminate program 
with :ABORT or :OFF. 



UNLBL 



file name UNDEFINED 



subsystem name UNDEFINED 



UNDEFINED EXTS 



WRONG INPUT 



name: nn xx 



DISCM User disc specified in :UD is unlabeled. If trying to change 

user disc assignment, enter :UD,*[,n] . 

JOBPR Undefined file name as a parameter of a directive. Retype 

correct file name on the system console. 1 

JOBPR Undefined subsystem name as a parameter of :MMGT direc- 

tive. Subsystem names must be defined at system generation. 

LOADR Undefined external references exist in programs loaded. The 

external references are listed one per line. To load additional 
programs from paper tape, type :GO,0[,n] . 

JOBPR Relocatable binary input furnished for a source file request 

or vice-versa. Enter correct input. 1 

ERRO Library routine error code, where name is the name of the 

user's program, nn is the routine identifier and xx is the 
error type. 



<a 



JOBPR/ 
DISCM 



Directives may be entered. Enter desired directive. 



DISCM Operator attention directives may be entered. Enter desired 

directive. 



This error causes a batch abort if the command is entered in batch mode. See "Batch Abort" in Section 1. 
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DOS-Ill EFMP ERROR CODES 



These error numbers are returned to the user program (in ERRNO) by the EFMP. The error 
numbers are also returned in the A register. 



Error No. Description 

No errors. 

1 Invalid EFMP function number. 

2 Duplicate file name. 

3 File name not in directory. 

4 File too long for this pack. 

5 Invalid record length. 

6 Pack number not available (or name not in directory if a search was made on 
all available pack directories). 

7 Invalid security code. 

8 A temporary file must be opened with a CREATE function. An OPEN function 
can only change the Temporary Record Buffer number of the starting record 
number for a temporary file. 

9 Buffer area specified in Exec call is not valid. 

10 Invalid Record Number. 

11 File not open. 

12 DEFINE not previously executed or Opened-File table used in previous DEFINE 
has been altered. Issue a new DEFINE. 

13 Backspaced beyond "start-of-file." 

14 No pack space available. 

15 Invalid pack number. 

16 No pack number entry is available in Opened-File table. 

17 Work Area space not sufficient. 

18 No Opened-File table space available. 

19 Invalid temporary record buffer number. 

20 Invalid number of EXEC call parameters. 
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Error No. Description 

21 End-of-File. 

22 COPY terminated. 

23 Invalid argument(s). 

24 Maximum number of files exceeded. 

25 File already OPEN. 

26 Record size larger than one-half of a temporary record buffer. 

27 Pack number previously initialized. 

28 Pack number not initialized. 

29 Directory requested is too large. 

30 Invalid number of active pack numbers. 



15-16 



PART 6 
Appendix and Indexes 



APPENDIX A 
System Tables 



This appendix contains figures and tables which represent the structure of the following 

• Main-memory layout, including 

main memory allocations in DOS-Ill 

DOS-Ill base page constants 

DOS-Ill base page communication area 

• Disc layout, including 

disc structure in DOS-Ill 
disc directory entry format 
disc labels 

• System I/O tables, including 

the equipment table 
the logical unit table 
the interrupt table 
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low memory 



high memory 



interrupt locations 



system base page area 



user base page area 



DISCM, the disc monitor 



main-memory resident 
drivers and EXEC modules 



system tables 



disc-resident EXEC 

module overlay area 

(optional) 



disc-resident I/O 

drivers overlay area 

(optional) 



user common area 
(optional) 



disc-resident user program area 
(main programs and segments) 



main-memory resident 
bootstrap disc loader 



location 40 



'8 



memory protect 
boundary 



Figure A-1. Main Memory Allocations in DOS-Ill 
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Table A-1. DOS-Ill Base Page Constants 



Location 

40 

41 
42 
43 
44 
45 
46 
47 
50 
51 
52 
53 
54 
55 
56 
57 
60 
61 
62 
63 
64 
65 
66 
67 
70 
71 
72 
73 
74 
75 
76 
77 



Type 

DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
OCT 
OCT 
OCT 
OCT 
OCT 
OCT 
OCT 
OCT 



Value 

-64 
-10 

-9 

-8 

-7 

-6 

-5 

-4 

-3 

-2 

-1 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

17 

64 

17 

37 

77 

177 

377 

1 77400 

3777 

177700 
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Table A-2. DOS-Ill Base Page Communication Area 



Location 



Name 



Contents 



100 


UMLWA 


101 


JBINS 


102 


JBINC 


103 


TBG 


104-5 


CLOCK 


106-7 


CLEX 


110 


CXMX 


111 


BATCH 


112 


SYSTY 


113 


DUMPS 


114 


SYSDR 


115 


SYSBF 


116 


SECTR 


117 


EQTAB 


120 


EQT# 


121 


LUTAB 


122 


LUT# 


123 


JBUF 


124 


JFILS 


125 


JFILC 


126-32 


RONBF 


133 


MDFLG 


134 


DISP 


135 


AEPF 


136 


SGRTN 


137 


XIRT 


140 


SVEQT 


141-53 


EXPG 


154 


DISCO 


155 


SYSSC 



Last word address of user available memory 

Start track/sector of Job Binary Area 

Current track/sector of Job Binary Area 

Time-base Generator I/O channel address 

Current system clock time (2 words) 

Execution clock time (2 words) 

Maximum allowable execution time 

Logical unit #of batch input device 

Logical unit #of system console 

Abort/Post Mortem dump flag 

System directory track/sector 

System buffer track/sector 

Number of sectors/disc track 

First word address of equipment table 

Number of equipment entries 

First word address of logical unit table 

Number of logical unit entries 

Job input buffer address 

Source file starting track/sector 

Source file current track/sector 

Parameter buffer (5 words) 

Mode flag for privileged I/O 

(Reserved for System use) 

Alternate entry point flag 

Segment return address 

System transfer address for interrupt-completion routine 

EOT address for I/O operations 

Directory entry for current program (11 words) 

Disc I/O channel/last track on disc 

System subchannel 
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Table A-2. DOS-Ill Base Page Communication Area (continued) 



Location 



Name 



Contents 



156 


SCCNT 


157 


UDNTS 


160 


SYNTS 


161 


CUDSC 


162 


CRFLG 


163 


CUD LA 


164 


FSFLG 


165 


CUMID 


166-70 


DBUFR 


171-73 


UBUFR 


174 


TSONE 


175 


GUDSC 


176 


SYSCD 


177 


JFLSC 


200 


DISCL 


201 


INTAB 


202 


INT# 


203 


EQT1 


204 


EQT2 


205 


EQT3 


206 


EQT4 


207 


EQT5 


210 


EQT6 


211 


EQT7 


212 


EQT8 


213 


EQT9 


214 


EQT10 


215 


EQT11 


216 


EQT12 


217 


EQT13 



Number of subchannels on system minus 1 

Next user disc track/sector 

Next system disc track/sector 

Current user disc subchannel 

Current disc request flag: for system, non-0 for user 

Current user disc last access 

File search flag 

Computer identification 

System disc triplet parameter buffer (3 words) 

User disc triplet parameter buffer (3 words) 

Last track/sector referenced +1 

Default user disc subchannel 

System generation code 

Source file subchannel 

User label track/sector 

First word address of interrupt table 

Number of interrupt entries 



EQT1-EQT17 are addresses of current equipment table 
entry 
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Table A-2. DOS-Ill Base Page Communication Area (continued) 



Location 



Name 



Contents 



220 


EQT14 


221 


EQT15 


222 


EQT16 


223 


EQT17 


224 


RQCNT 


225 


RQRTN 


226 


RQP1 


227 


RQP2 


230 


RQP3 


231 


RQP4 


232 


RQP5 


233 


RQP6 


234 


RQP7 


235 


RQP8 


236 


NABRT 


237 


XA 


240 


XB 


241 


XEO 


242 


XSUSP 


243 


EXLOC 


244 


EX# 


245 


EXMOD 


246-47 


EXMAN 


250-51 


EXBAS 


252 


IODMN 


253 


IODBS 


254 


UMFWA 


255 


UBFWA 


256 


UBLWA 



EQT1-EQT17 are addresses of current equipment table 
entry 



Number of request parameters 
Current request return address 



RQP1-RQP8 are addresses of current request 
parameters 



Illegal request code abort/no abort option 

A register contents at time of interrupt 

B register contents at time of interrupt 

E and register contents at time of interrupt 

Point of suspension at time of interrupt 

Address of Exec module doublet table 

Number of Exec module doublet table entries 

Exec module # currently in Exec module overlay area 

Exec module low and high main memory addresses (2 words) 

Exec module low and high base page memory addresses 
(2 words) 

First word address of I/O driver module main area 

First word address of I/O driver module base page area 

First word address of user main area 

First word address of user base page area 

Last word address of user base page area 
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Table A-2. DOS-Ill Base Page Communication Area (continued) 



Location 



Name 



Contents 



257 


CHAN 


260 


OPATN 


261 


OPFLG 


262 


SWAP 


263-64 


JOBPM 


265 


JOBPB 


266 


EJOBF 


267 


RTRK 


270 


DUMMY 


271 


MPTFL 


272 


$GOPT 


273 


$IDCD 


274-75 


$MDBF 


276-304 


TEMP 


305 


TEMPO 


306 


TEMPI 


307 


TEMP2 


310 


UTMP0 


311 


UTMP1 


312 


UTMP2 


313 


MSECT 


314 


VADR 


315 


IODMD 


316 


RCODE 


317 


SXA 


320 


SXB 


321 


SXEO 


322 


SXSUS 


323 


EFMP 



Current DMA channel number 

Operator/keyboard attention flag 

Operator communication flag 

Job processor resident flag 

Job processor disc address/number of words in main 
(2 words) 

Job processor base page number of words 

End-job flag 

Real time simulation track number 

Reserved for system use 

Memory protect flag 

Point of suspension continuation address 

Input request code check 

Exec module data buffer (2 words) 

Reserved for data communications (7 word buffer) 

Reserved for System use 



User-available Temporary 

Negative number of sectors/track 

Address of instruction causing memory protect violation 

Current resident I/O driver module flag 

Current request code value 

Operator attention restore A register value 

Operator attention restore B register value 

Operator attention E and O register value 

Operator attention return address 

Extended File Management Package flag 
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Table A-2. DOS-Ill Base Page Communication Area (continued) 



Location 



Name 



Contents 



324 


DSCLB 


325 


DSCL# 


326 


LSTCH 


327 


FLFLG/TRAC# 


330 


XFLG 


331 


SSFLG 


332 


CHARC 


333 


TYEQT 


334 


DMFLG 


335 


SSTBL 


336 


TMBEG 



Disc track/sector of Relocatable Library 

Number of Relocatable Library routines 

Last disc referenced 

User file table validity flag/#Bad tracks found 

Entry address for disc not ready 

System search flag 

Batch input character count 

System console EQT4 address 

Data Management Flag 

Address of Subsystem Table 

Address of Timer List 
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track 



one directory entry 
for each disc- ( 

resident module 



track boundary 



track boundary 



system label sector 



bootstrap 



system area directory (size varies) 



main memory-resident system 



equipment table (EQT) 



device reference table (DRT) 



interrupt table (INT) 



EXEC modules 



I/O driver modules 



system programs 



EXEC module table 



relocatable library 



base page linkages 



system buffer/user label sector 



user directory 



user files 



work area 



job binary area 



SYSTEM AREA 
(hardware protected) 



> USER AREA 



Figure A-2. Disc Structure in DOS-Ill 
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WORD 



CONTENTS 



10 



11 



first character 


second character 


third character 


fourth character 


fifth character 


P 


entry type 


track 


sector 


file length (in sectors) 


FWA program 


LWA program 


FWA base page linkage area 


LWA base page linkage area 


program entry point 


FWA of memory available for memory management (see Note) 



(five-character 
file name) 



for system or 
' loader-generated 
binary programs 
only 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



BITS 



Note: For overlays, word 1 1 value is the last word (plus 1) of the 
overlay. For a main program, word 1 1 value is the last word 
(plus 1) of the largest segment. 



Figure A-3. Disc Directory Entry Format 
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T* Bit 

= Permanent file — no action is taken at end-of-job. 

1 = Temporary file— purge this entry at end-of-job. 

This bit is set by the Relocating Loader and cleared by a STORE,P directive. 

Entry Type 

Type File 

System resident 

1 Disc-resident executive supervisor module 

2 Reserved for system 

3 User program, main 

4 Disc-resident device driver 

5 User program segment 
6,7 Library 

10 8 Relocatable binary 

11 8 ASCII source statements 

12 8 Binary data 

13 8 ASCII data 

14 8 Absolute binary 

Note: The last directory entry in each sector is followed by a word containing -1. 
The last entry in the directory is followed by a word containing zero (0). 
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DISC LABELS 

Sector of track of each disc is used for label information. In addition, if the user area is on the 
system disc, a label also exists in Sector of the first track after the system area. The first 64 words 
(words 0-63) are reserved for label information. Word 64 contains the next available track and sector. 
Words 65 and 66 contain the number of bad tracks and the next available spare track. 

The contents of the label include: 

Word 0: Label presence code (ASCII "LB" for labeled, zero for unlabeled) 

Word 1: System proprietary code: 

1. "DO" for DOS-Ill 



2. 



urrin )) 



TS" for Time-shared BASIC 



Word 2: System generation code assigned at system generation time. The code can be any four 
decimal digits. 

Words 3-5: A six-character disc label. If the first character equals * the disc is unlabeled. This 
label can only be set using :IN (for user areas) or by DSGEN (set to "SYSTEM" 
for system discs). 

Word 31: Checksum of words 0-30. 
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THE EQUIPMENT TABLE 

The equipment table (EQT) has an entry for each device recognized by DOS-Ill (these entries are 
established by the user when DOS-Ill is generated). The EQT entries reside in the permanent main- 
memory resident part of the system and have this format: 

D = 1 if DMA channel required. 

R = 1 if driver type is main-memory resident. 

Unit # May be used for subchannel addressing. 

Channel # I/O select code for device (lower number if multiboard interface). 

Av =0 Unit not busy and available 

= 1 Unit disabled (down) 

= 2 Unit busy 

Status— Actual or simulated unit status at end of operation. 

Equipment Type Code— Identifies type of device and associated software driver. Assigned equip- 
ment type codes in octal are: 



00-07 


Paper Tape Devices 


00 


Teleprinter 


01 


Punched Tape Reader 


02 


High Speed Punch 


04 


Display Terminal 


05 


System Console 


10-17 


Unit Record Devices 


11 


Card Reader 


12 


Line Printer 


20-37 


Magnetic Tape/Mass Storage and other devices capable of both input 




and output 


23 


7970 Magnetic Tape 


26 


2762A Terminal Printer 


31 


Moving-Head Disc 


33 


Writable Control Store 



For equipment type codes 01 through 17, odd numbers indicate input devices and even numbers 
indicate output devices (except 05, which is both input and output). 
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WORD 



CONTENTS 



10 



11 



12 



13 



14 



15 



16 



17 



driver "initiation section" address 



driver "continuation section" address 



Av 



(reserved) 



unit # 



equipment type code 



(saved for driver use) 



(saved for driver use) 



request return address 



(reserved for system) 



current I/O request control word 



request buffer address 



request buffer length 



temporary or disc track # 



temporary or starting sector # 



temporary storage for driver 



channel # 



status 



request code 



upper memory address: main driver area 



upper memory address: driver linkage area 



starting track # 



starting sector # 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



All zeros if 

main-memory 

resident 



BITS 



Figure A-4. The Equipment Table 
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THE LOGICAL UNIT TABLE 

The logical unit table (LUT) has an entry for each logical unit defined at system generation time 
(maximum number is 63). These entries provide logical addressing of the physical devices defined 
in the EQT. Logical unit numbers 4-63 may be modified within a job by using the LU directive. 
At end-of-job, logical unit number 1-9 are restored to their original system generation values. The 
LUT entries reside in the permanent main-memory resident part of the system and have the follow- 
ing format: 



Word 



Contents 



Device EQT number 



Device EQT number 



THE INTERRUPT TABLE 

The interrupt table (INT) contains an entry, established at system generation time, for each I/O 
channel which can cause an interrupt (beginning with I/O channel 6). The INT entries reside in the 
main-memory resident portion of the system and have the following format: 



The entry is in the following form: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



EQT address of device 



D = no DMA interrupts expected 
D = 1 DMA interrupts expected 

Bit 15 is set and cleared by calls to $SDMA and $CDMA, respectively. 
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INDEX 1 
Summary of Directives 



Directive 
.ABORT 

:ADUMP[,FWA [,LWA] ] [,BJ [,S] 
.BATCH, logical unit 

: CLE AR[, logical unit] 

:COMMENT string 
:DATE, day [, hour, min] 

:DD 

:DD,X 

:DD,U[,file[,(name)] ,file[,(name)] . . .] 

:DN,n 

:DUMP,logical unitJile^S]^ [,S 2 ]] 

:EA[,P V P 2 ,P 3 ,P 4 ,P 5 ] 

:EB[,Pj ,P '2,P^4,Pg] 

■.EDIT, file, logical unit [, new file] 



Description Page 

Terminate the current job 2-3 

Dump a program if it aborts 2-13 

Switch from keyboard to batch mode, or 2-4 

reassign batch device 

Clear the Job Binary Area or issue a 2-5 

clear request to an I/O device 

Print a message on the system console 2-6 

Set the date (and the time, if Time-base 2-7 

Generator is present) 

Dump the entire current disc onto a disc 2-9 

on another subchannel 

Dump the system area only to another 2-9 

disc 

Dump all or specified files of the current 2-9 

user disc to another disc, optionally as- 
signing new file names 

Declare an I/O device down 2-8 

Dump all or part of a user file to a 2-11 

peripheral I/O device 

Execute user EXEC module $EX36 12-2 

Execute user EXEC module $EX37 12-2 

Edit a source statement file stored on 2-17 

disc, optionally creating a new file 



:EF[,logical unit] 



Write end-of-file on magnetic tape 
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Directive 
:EJOB 

:EQ[,n] 

:GO[,P 1 ,P 2 , . . . ,P 5 ] 
: IN, label 
:JFILE,file 

:JOB[,name] 

: LIST, S, logical unit,file[,m[,nj ] 

: LIST, U, logical unit[,filep . . .] 
:LIST,X,logical unit[,filep . . .] 

:LU[, ni [,n 2 ]] 

:MMGT[, subsystem name,wwwww,. 
subsystem name,wwwww] 

.OFF 

: PAUSE [comment string] 

PDUMP[,FWA[,LWA]] [,B] [,S] 
PROG,name[,P 1 ,P 2 ,. . . ,P 5 ] 
PURGE [Jilep file 2 . . .] 

:RNAME,oldname,newname [, type] 

:RPACK 

RWND[,logical unit] 
R UN,name[, time] [,N] 
SA,track, sector], number] 
:SO, track,sector[, number] 

:SS 
:SS,n 1 ,n 2 . . . 



Description Page 

Terminate the current batch and/or job 2-22 
normally 

List the complete equipment table, or 2-23 
just one line 

Continue processing a suspended program 2-25 

Label or unlabel ("*") the current user disc 2-26 

Specify a source file on the disc for the 2-43 
Assembler or a compiler 

Initiate a user job 2-28 

List all or part of a source statement file 2-29 

List all or part of the user directory 2-29 

List all or part of the system directory 2-29 

Assign or list logical unit assignments 2-33 

Reserve memory address space (in words) 2-35 
for specific subsystems or obtain a list of 
previously reserved memory space 

Abort the currently executing program or 2-37 
operation without terminating the job 

Suspend the current job or program (optionally, 2-38 
output a comment on the system console) 

Dump a program after normal completion 2-13 

Turn on a system or user program 2-39 

Delete all temporary file or specified user file 2-40 
directory entries. 

Rename a specified user file and option- 2-42 
ally, change its program type 

Repack disc user file area eliminating purged 2-44 
files (see : PURGE directive) 

Rewind a magnetic tape 2-43 

Run a user program 2-45 

Dump disc in ASCII to standard list device 2-15 

Dump disc in octal to standard list device 2-15 

Set up system search for file names over 2-52 
all subchannels 

Set up system search for file names over 2-52 
specified subchannels 



Directive 



:SS,99 



:STORE,A,file,sectors 
:STORE,B,file,sectors 
STORE, P[, name },name 2 . . .] 

:STORE,R,file[,logical unit] 

:STORE,SJile, logical unit[,C] 

:STORE,X,file,logical unit 
:TOF[,logical unit] 
.TRACKS 

.TYPE 

:UD[,[label][,n]] 



Description Page 

Restrict search for file names to current 2-52 

user disc (plus system directory for RUN 
and PROG) 

Reserve space for an ASCII data file 2-47 

Reserve space for a binary data file 2-47 

Store all or specified temporary Loader- 2-47 

Generated programs as permanent files 

Store a relocatable file from the JBIN 2-47 

area of disc after an assembly or compila- 
tion or from a peripheral I/O device 

Store a source statement file from a 2-47 

peripheral I/O device 

Store absolute binary programs 2-47 

Issue a top-of-form to a list device 2-54 

Print the disc track status of the current 2-55 

user disc 

Return to keyboard mode from batch 2-57 

mode 

Change the subchannel assignment for the 2-59 

user disc, or request label and subchannel 
information for a user disc 



:UP,n 



Declare an I/O device up 
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INDEX 2 
Summary of EXEC Calls 



Consult Section III for the complete details on each EXEC call. 



RCODE Name 

-19 BASE PAGE STORE 

1, 2 I/O READ/WRITE 



3 


I/O CONTROL 


6 


PROGRAM COMPLETION 


7 


PROGRAM SUSPENSION 


8 


SEGMENT LOAD 


10 


PROGRAM LOAD 


11 


TIME REQUEST 


13 


I/O STATUS 


14,15 


FILE READ/WRITE 



16 



17 



18 



WORK AREA STATUS 



WORK AREA LIMITS 



FILE NAME SEARCH 



Function Page 

Store values into base page memory loca- 3-6 

tions (Value to be stored in the A register, 
absolute location address in the B register) 

Transfer input or output (1 = read or 3-20 

2 = write) 

Carry out control operations 3-17 

Signal end of program 3-30 

Suspend calling program 3-33 

Load segment of calling program 3-35 

Transfer a main program into main 3-31 

memory 

Request the time-of-day 3-38 

Request device status 3-23 

Read or write a user data file (14 = 3-13 

read or 15 = write) 

Ascertain if n contiguous work tracks 3-41 

are available 

Ascertain first and last tracks of work 3-39 

area 

Ascertain if a file name exists in the 3-9 

directory 



RCODE 


Name 


23 


USER DISC CHANGE 


24 


EFMP CALLS 


27,28 


USER EXEC CALLS 



29 

30 

31 
32 

33 

34 

35 

36 



SEGMENT RETURN 



MEMORY PROTECT 
CONTROL 



Function 

Change the current user disc subchannel 

Execute EFMP functions 

Execute user EXEC modules $EX36 or 
$EX37 (RCODE = 27 for $EX36; 
RCODE = 28 for $EX37; up to five 
words of parameter information) 

Return from a segment to the main 
program at the instruction immediately 
following the segment load call 

Control memory protect from a user 
program 



Page 

3-43 
Section VII 
Section XII 



(Reserved for future assignment) 



FILE CREATE 



FILE PURGE 



FILE RENAME 



MEMORY MANAGE- 
MENT (INITIALIZE) 

MEMORY MANAGE- 



Allows user to create a user disc file under 
program control. 

Allows user to purge a user disc file under 
program control. 

Allows user to rename a user disc file under 
program control. 

Reserves a block of memory under a unique 
block name identifier specified by the user. 



Requests number of words allocated to speci- 
MENT (STATUS REQUEST) tied block name identifier, or number of re- 
maining unallocated words if block name 
identifier is omitted. 
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3-29 



3-7 



3-11 



3-15 



3-26 



3-28 



37 
38 



39 
40 
41 



(Reserved for future assignment) 



MEMORY MANAGE- 
MENT (BUFFER 
ALLOCATION) 



Allocates buffer area from memory space. If 
the block name identifier is specified, the 
buffer allocation is from the area reserved for 
the block name. If not, the allocation is from 
the available memory area. 



(Reserved for future assignment) 



(Reserved for future assignment) 



MEMORY MANAGE- 
MENT (BUFFER 
RELEASE) 



Permanently releases buffer space. If the buffer 
resides within an area reserved under a block 
name identifier, the logical address space remains 
reserved. 
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INDEX 3 
Index of Terms 



ACROl: 1-17 

ADUMP: 2-13,2-37 

ALGOL CODE procedure: 3-3 

ALGOL control statement: 5-5 

alternate entry -point flag (AEPF): 3-22, 3-36 

ASCII dump format: 2-15 

assembler control statement: 5-9 

Assembler, FORTRAN and ALGOL Error 

Messages (5951-1377): 15-1 
assembler NAM statement: 5-10 
assembler ORB statement: 5-10 
ATD01: 1-17 
ATD02: 1-17 



B 



BACKSPACE: 3-19 

backward motion request: 4-7 

base page communication area: A-4 

base page contents: A-3 

base page linkage area: 2-13 

base page linking mode: 5-10, 10-12 

batch abort: 1-3,2-50 

BINRY library routine: 3-22, 5-28 

BREAD entry point: 3-22 

BRIEF temporary file: 9-4 

BWRIT entry point: 3-22 



DSGEN: 


10-1 




DVR00: 


1-16, 


,4-3 


DVR01: 


1-16. 


,4-3 


DVR02: 


1-17, 


4-3 


DVR05: 


1-16, 


4-3 


DVR10: 


1-17, 


4-3 


DVR11: 


1-17, 


4-3 


DVR12: 


1-17, 


4-3 


DVR15: 


1-17, 


4-3 


DVR23: 


1-17, 


4-3 


DVR26: 


1-17, 


4-3 


DVR31: 


1-16, 


4-3 


DVR33: 


1-17, 


4-3 


DVR34: 


1-17, 


4-3 


DVR67: 


1-17, 


4-3 



E 



EFMP areas: 7-2 

EFMP directory size: 8-10 

EFMP function numbers: 8-1 

EFMP pack numbers: 7-2 

EFMP file security code: 7-2, 8-6, 9-18 

ENDFILE: 3-19 

equipment table: 2-33, 4-2, 10-15, A-13 

equipment table format: A-13 

equipment table generating: 10-15 

EQT status field: 4-3 

ERR0 library routine: 5-19 



central interrupt processing routine ($CIC): 1-5, 4-3 

commercial "at" sign @: 2-1, 2-50 

configured DSGEN: 1-9, 10-1 

Control-A: 1-3 

current page linking mode: 5-10, 10-12 



D 



device independence: 1-5 

device reference table: 2-33, 4-2, 10-16, A-15 

directory listing output: 2-30 

disc labels: A-12 

disc monitor (DISCM): 1-1 



file name search: 3-9 
FORTRAN control statement: 5-13 
FORTRAN DATA statement: 5-16 
FORTRAN EXTERNAL statement: 5-17 
FORTRAN PAUSE statement: 5-18 
FORTRAN PROGRAM statement: 5-15 
FORTRAN STOP statement: 5-18 
function code field: 3-18 
FWA: 2-13 



G 



Generate DOS-Ill: 10-7 



H 



hardware override switch: 1-9, 2-26, 10-5 

head 0, drive 0: 11-12 

HLT 31: 2-26 

HP FORTRAN IV (5951-1321): 15-1 



I 



input string length: 2-1 
interrupt table: 4-2, 10-16, A-15 
interrupt table format: A-15 
interrupt table generating: 10-16 
I/O operation, without wait: 14-1 
IPRAM: 3-14 



job binary area: 1-14, 2-5 



K 
keyboard mode: 1-3 



PMT02: 1-17 

PN000: 8-5 

Prepare Tape System (02116-91751): 10-1 

primary file: 2-17 

privileged interrupt: 1-5, 13-20 

privileged mode flag (MDFLG): 14-1 

program entry type: A-ll 

program input unit: 5-10, 10-12, A-10 



R 



request codes: 3-1 

relocatable libraries: 5-28 

Relocatable Subroutines (02116-91780): 5-28 

relocating loader: 5-20 

restarting DSGEN: 10-7 

return: 1-3, 

REWIND: 3-19 

RMPAR library subroutine: 2-25, 3-46 

RONBF parameter buffer: 3-46 

RTE/DOS FORTRAN IV library: 5-28 

RTE/DOS relocatable library: 5-28 

rubout: 1-3 



label presence code: 7-1, A-12 

library input unit: 10-10 

linefeed: 1-3 

link mode: 5-10, 10-12 

LOADR current page linking parameter: 5-22 

LOADR debug parameter: 5-22 

LOADR input parameter: 5-21 

LOADR program bounds specification parameter: 5-22 

logical unit table: 2-33, 4-2, 10-16, A-15 

logical unit table format: A-15 

logical unit table generating: 10-16 

LWA: 2-13 



M 



memory management: 1-9, 2-35, 3-24 



N 



secondary file: 2-18 

sector boundaries: 2-12 

sector numbers: 2-11 

sense switch control: 5-5 

source listing output: 2-31 

SS condition: 2-10, 2-29, 2-52 

SLC: 1-17 

standard list device: 2-22 

standard logical unit numbers: 4-2 

subchannels: 1-10, 1-13 

summary of directives: index 1 

summary of EXEC calls: index 2 

system area: 1-8 

system area directory: 2-29 

system area dump: 2-9 

system area files: 2-12 

system generation code: 10-5, A-12 

system proprietary code: 7-1, A-12 



NAM statement: 5-10 



o 



octal dump format: 2-15 
opened-file table: 7-2 
opened-file table size: 8-2 
operator attention directives: 2-2 
optional directive (:SS): 2-29, 2-52 
override/protect switch: 1-9, 2-26, 10-5 



Pbit: A-ll 
PDUMP: 2-13, 
PMT01: 1-17 



2-37 



temporary record buffers: 7-2 
temporary record buffer size: 8-3 
termination record: 2-49 
timing capabilities: 1-6 
track switching: 3-20 
transmission log (TLOG): 3-23 
type A files: 2-50 
type B files: 2-50 
type P files: 2-48 
type R files: 2-47 
type S files: 2-49 
type X files: 2-51 



u 

unassigned logical units: 10-16 

user area: 1-1,1-9,1-14 

user area directory: 2-29 

user area dump: 2-9 

user file types: 2-47 

user source file: 2-29 

user status word (USTAT): 8-25 



w 



wait field: 3-18 

waiting and no waiting: 3-22, 4-3 

work area: 1-8 

write end-of-file: 3-17 



$ 



$EX01 . . . $EX12: 10-13 
$EX13 . . . $EX22: 10-14 
$EX30 . . . $EX33: 10-12, 10-14 
$EX36: 3-1, 10-12, 12-3 
$EX37: 3-1, 10-12, 12-3 



/ 



/DELETE: 2-18 
/END: 2-19 
/INSERT: 2-18 
/MERGE: 2-18 
/REPLACE: 2-18 
/SUPPRESS: 2-19 
/UNSUPPRESS: 2-19 



